SHOWJCW

Operation Notes

The SHOWJCW command is used to display the current state of one or more job control words (JCWs). Job control words in MPE/iX are classed as variables of type JCW. Specifying a particular JCW (user-defined, system-defined, or system-reserved) displays the value of that particular JCW. If you do not specify a particular JCW, user-defined and system-defined JCWs are displayed. The value of the third type of JCW, system-reserved JCW, is displayed only if you specifically enter its jcwname. The SHOWVAR command can be used to show variable values as well.

You may retrieve the value assigned a JCW with the FINDJCW and HPCIGETVAR intrinsics.

You may test the value of a JCW with an IF or WHILE command. In this way, the value of a given JCW can be used to conditionally execute another instruction or set of instructions. For example:

  !CONTINUE
  !SPL MYPROG,MYUSL
  !IF JCW>=FATAL THEN
  !  TELL USER.TECHPUBS;COMPILE FAILED
  !ELSE
  !  TELL USER.TECHPUBS;COMPILE COMPLETED
  !ENDIF

Use

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

Examples

To show the current state of all user-defined and system-defined JCWs, enter:

  SHOWJCW
 JCW = 0
 CIERROR = 0

To display the current state of a valid user-defined job control word named JCW1, enter:

  SHOWJCW JCW1
 JCW1=3

To display the contents of a system-reserved JCW, enter:

  SHOWJCW HPDAY
 HPDAY=4