Previous Topic

Next Topic

Book Contents

Book Index

IOATEST Parameters

Table 82 IOATEST Parameters

Parameter

Description

CMD

Issue an operator command. The command can be either an MVS/JES command or, when MVS is running under VM, a CP command. (CP commands must start with characters CP.) Maximum text length: 76 characters.

Note: The IOATEST utility does not support issuing commands whose syntax requires a comma. To issue commands whose syntax includes commas, use the IOAOPR utility described on IOAOPR – Issue Operator Commands Using a Job or STC.

WTO

Write message to operator console. Maximum text length: 76 characters.

WTOR

Write message to operator console with reply. Maximum text length: 75 characters.

WTOM

Issue multiline message. major is the primary message line.

Subsequent minor lines are secondary message lines, delimited by a +++ line. A maximum of ten message lines are permitted.

Example

WTOM= major

      Minor 1

      Minor 2

      minor n

      +++

ROUT

Valid route code from 0 through 16 (0 meaning no route code). Default: all route codes.

DESC

Valid descriptor code from 0 through 16. Default: 0 (none).

CONID

Console ID to which the message is issued. Valid range: 0 – 999. Default: master console, if one exists.

CONNAME

Name of the console to which the message is sent, or on that the command is issued.

SYSTEM

Name of the system (meaning, the MVSIMAGE) to which the message is sent, or on that the command is issued.

JOBNAME

Name of the job that issued the message.

JOBID

The JES2 or JES3 job ID of the job that issued the message.

Note: Parameters SYSTEM, JOBNAME and/or JOBID can be used to simulate messages coming from another member of a Sysplex environment or JES3 complex.

DEFDELAY

The period, in hundredths of a second, that the program waits before a WTO or WTOR or WTOM message or command is executed and the program ends. 1 to 4 digits. Default: 100 (one second)

WAIT

Cause the step to wait n seconds. Valid range: 0 – 999.

TERM=Cnnnn

Condition code to be simulated. Valid range for nnnn: 0000 – 4095.

TERM=Unnnn

User abend code to be simulated. Valid range for nnnn: 0000 – 4095.

TERM=Snnn

System abend code to be simulated. Valid hexadecimal range for nnn: 000 – FFF.

WTO, ROUT, DESC, CONID, CMD, WAIT and TERM can also be specified in the PARM keyword of the EXEC job step. If this method is used, only the PARM parameters are executed in the following order: WTO, WAIT, TERM. When using PARM, DEFDELAY is always 0.

Parent Topic

IOATEST – Simulate Production Environment Events