Parameters

jobname
The name of the job that invokes the APPC/MVS administration utility.
stepname
The name of the step that invokes the APPC/MVS administration utility (ATBSDFMU) and specifies a TYPRUN condition. TYPRUN controls the action the utility performs on the profile and side information data entered as SYSIN input.
condition
Indicates one of three TYPRUN actions (on the EXEC statement) for the SYSIN input:
SCAN
Syntax check only the utility command and keywords.
APPC
If MVS/ESA SP 4.2 or later has been installed, perform all services. If MVS/ESA SP 4.2 or later has not been installed, perform all services except TP profile addition and modification services. TP profile addition and modification services are scanned only.
RUN
Perform all services regardless of the release level. However, if MVS/ESA SP 4.2 or later has not been installed, the JCL portion of the transaction scheduler section in TP profiles cannot be validated. If an attempt is made to run the TP with JCL syntax errors, the TP fails with no JCL messages to indicate the nature of the problem.

RUN is the default for TYPRUN and the recommended parameter when using the utility on a lower level system.

SYSSDLIB
Identifies the VSAM KSDS into which definitions will be placed or from which definitions are retrieved. The VSAM KSDS specified must have been previously created.
SYSSDOUT
Identifies a data set that will receive output from the APPC/MVS administration retrieval services. The data set can be previously allocated with a recommended format of fixed blocked records with a record length of at least 120 bytes.
Retrieved output consists of /* and the command name that requested the output, the SYSIN input for the service, and a blank line followed by the requested output. For example, output for a TPRETRIEVE is displayed as follows: 
  ┌───┐   ┌────────────────────┬────────────────────┐
  │ R1├──>│Addr of TYPRUN Info │ Addr or DDNAME Info│
  └───┘   └───────┬────────────┴───────────┬────────┘
                  │                        │
                  │                        │
                  ↓                        ↓
 ┌────────────────────────┐   ┌───────────────────────────┐
 │ Length (2 bytes signed)│   │Length (2 Bytes signed)    │
 ├────────────────────────┤   ├───────────────────────────┤
 │ TYPRUN=xxxx            │   │Reserved for IBM  (8 Chars)│
 └────────────────────────┘   ├───────────────────────────┤
  xxxx=RUN, APPC, SCAN        │Reserved for IBM  (8 Chars)│
                              ├───────────────────────────┤
                              │Reserved for IBM  (8 Chars)│
                              ├───────────────────────────┤
                              │Reserved for IBM  (8 Chars)│
                              ├───────────────────────────┤
                              │SYSSDIN                    │ /* Overrides
                              ├───────────────────────────┤ /* SYSIN
                              │SYSSDPRT                   │ /* Overrides
                              └───────────────────────────┘ /* SYSPRINT
SYSPRINT
Identifies a data set that can receive general statement and message output from the APPC/MVS administration utility. The data set can be previously allocated with a recommended format of fixed blocked records with a record length of at least 120 bytes.

A SYSPRINT DD statement is required for all administration utility services. The default message output class for SYSPRINT is SYSOUT=A.

SYSIN
Identifies the input stream or name of a data set in which the APPC/MVS administration utility command is specified along with the necessary TP profile or side information data. Some commands, such as the key retrieval commands, require no TP profile or side information data. Most of the commands, however, require a part or all of the TP definition.
Note: In case of a severe error returned by the APPC/MVS administration utility, you can attempt to capture a dump by including one of the following DD statements:

For more information, see z/OS MVS JCL Reference.

Parent topic: Invoking the APPC/MVS Administration Utility from a Batch Job