- 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:
- //SYSABEND DD ...
- //SYSMDUMP DD ...
- //SYSUDUMP DD ...
For more information, see z/OS MVS JCL Reference.