OSP - Parameters for z/OS Batch

The parameters for z/OS batch can be specified as subparameters of profile parameter OSP or macro NTOSP.

Possible settings See OSP Parameter Syntax.
Default setting See Keyword Subparameters.
Dynamic specification yes The parameter OSP can only be specified dynamically. In the Natural parameter module, use the macro NTOSP.
Specification within session no  

The following topics are covered:


OSP Parameter Syntax

The OSP parameter is specified as follows:

OSP=(keyword-subparameter=value,keyword-subparameter=value,...)

For information on subparameter names and values, see Keyword Subparameters.

NTOSP Macro Syntax

The NTOSP macro is specified as follows:

         NTOSP ABEXIT=value,                                           *
               DUMPDSN=value,                                          *
               LBPNAME=value,                                          *
               LEHDLR=value,                                           *
               SUBPOOL=value,                                          *
               TIOBSZ=(value1,value2),                                 *
               USERID=value

See Keyword Subparameters.

Keyword Subparameters

ABEXIT | DUMPDSN | LBPNAME | LEHDLR | SUBPOOL | TIOBSZ | USERID

ABEXIT - Abend Processing

ABEXIT=value specifies the mode of abend processing within Natural.

Value Explanation
ESTAE Natural intercepts all abends and issues the appropriate error messages.

This is the default value.

SPIE Only program checks (S0Cx abends) are intercepted.
OFF Natural does not intercept any abends or program checks at all. This value corresponds to profile parameter DU=FORCE.

Note:
The setting ABEXIT=OFF is not recommended because some functions, which require the abend interception, will not work any longer. The usage of profile parameter MT will cause an abend U0322 instead of error NAT0953 when the CPU time limit is reached.

DUMPDSN - Dump Data Set Name Prefix

DUMPDSN=value can be used to define the prefix for a dynamically allocated dump data set. Then each dump will be written by the z/OS service IEATDUMP to a separate data set instead of the standard data set (SYSUDUMP or SYSMDUMP). This can be very helpful in batch server environments when multiple dumps from different Natural sessions must be written.

The complete dump data set name will be as follows:

value.D&YYMMDD.T&HHMMSS.&SYSNAME.&JOBNAME
Value Explanation
1 - 8 characters High level qualifier for the dump data set name.
' ' (blank)

No dumps are written by means of IEATDUMP. Instead, any dumps are written to the standard dump data set (SYSUDUMP or SYSMDUMP) if allocated.

This is the default value.

LBPNAME - Sharing of Local Buffer Pools

LBPNAME=value controls the sharing of the local buffer pools when running multiple Natural sessions within the same region.

Value Explanation
1 - 8 characters Name of shared local buffer pool environment.
' ' (blank) The local buffer pools are not shared.

This is the default value.

Notes:

  1. LBPNAME defines the name of the shared local buffer pool environment, and is used to locate the shared local buffer pool.
  2. When running multiple Natural sessions in a z/OS batch or TSO region concurrently, each session allocates storage for a separate local buffer pool. Except for the Natural z/OS batch mode server, the local buffer pools are not shared by default, that is, if the different sessions use the same Natural objects, these have to be loaded once for each session separately. If a name is specified, all Natural sessions will share the same local buffer pool.

LEHDLR - Use of an LE Error Handler for Calling LE Subprograms

LEHDLR=value specifies whether Natural uses an LE error handler for the call of LE subprograms.

Value Explanation
ON An LE error handler is set up by Natural during the call of LE subprograms. This means, if an unhandled LE error occurs during the execution of an LE subprogram, Natural will get control and can handle it (by issuing error NAT0954).

This is the default value.

OFF No set-up of an LE error handler is done by Natural during the call of LE subprograms. This means, if an unhandled error occurs during the execution of a LE subprogram, the LE enclave is terminated and so the Natural session is lost.

Notes:

  1. For information on LE runtime options, see the description of source module NATLEOPT in the Installation for z/OS documentation.
  2. For information on Natural running with the IBM Language Environment, refer to Natural Execution - Miscellaneous Topics, LE Subprograms in the Operations documentation.

SUBPOOL - Storage Subpool for GETMAIN Requests

SUBPOOL=value specifies the storage subpool for GETMAIN requests.

Value Explanation
1 - 127 Subpool number.
0 This is the default value.

Notes:

  1. The subparameter SUBPOOL is honored only in the Natural parameter module which is linked to the batch driver, but not in an alternative parameter module which is activated using a PARM= specification.
  2. As the subparameter SUBPOOL is evaluated during session initialization only, it cannot be specified as a dynamic subparameter.

TIOBSZ – Size of the Primary I/O Buffer for Batch Processing

TIOBSZ=(value1,value2) specifies the size of the primary I/O buffer for batch and/or server processing.

Value Explanation

 
value1
value2

Size of the primary I/O buffer in KB.
Batch size: 4 - 32 KB. It is allocated below the 16 MB line.
Server size: 32 - 999999 KB. It is allocated above the 16 MB line.

(8,64) This is the default setting.

Alternative Specifications:

  • TIOBSZ=10 or TIOBSZ=(10) defines only the batch size.

  • TIOBSZ=(,33) defines only the server size. The value which is not specified will remain unchanged.

USERID - Content of System Variable *INIT-USER

USERID=value specifies the content of the system variable *INIT-USER.

Value Explanation
ON The variable is set to either the user ID from the security access control block (ACEE) if a security package (as RACF or ACF2) is involved or the USER parameter from the job card.
OFF The user ID is the job name.

This is the default value.

Notes:

  1. The content of *INIT-USER can be changed by the user ID exit NATUEX1 during session initialization.
  2. For further information, see Configuring Natural, Natural User Exits, NATUEX1 - User Exit for Authorization Control in the Operations documentation.

Example of OSP Parameter

OSP=(LBPNAME=NATTEST1,USERID=ON)

Example of NTOSP Macro

         NTOSP LBPNAME=NATTEST1,USERID=ON