Example Participant information request and message

The message provides information about jobs running in the defined address space. The displayed information is divided into Job information and Pipe Information.

Example

To request participant I/O information for ASID 82 enter the following command:

F MBOP,DISPLAY ASID=82

The following figure is an example of the participant information message.

Example participant information message

BMC282136I          ASID 00180 
BMC282136I         ============ 
BMC282136I JOBNAME.... E02P JOBID...... JOB21590 STEP-NUM... 01 
BMC282136I PIPE: PROD.TRANS.FILE ID: 11151078
BMC282136I ---------------------------------------------------
BMC282136I TYPE....... WRITER      PIPETYPE... MANUAL 
BMC282136I LAST-ACT... 11:15:14    STAT....... 
BMC282136I PHASE...... WAITOPEN    PRT-FLG.... PIPE-FLG... 
BMC282136I PIPE-FL2...             STEP-NUM... 01 
BMC282136I DDNAME..... OUTFILE     HOME-SYS... OS35 
BMC282136I TIMESTMP... 1115107818620000 FLAG1......

The following tables describe the fields in the participant information message.

Job information fields

Field

Description

ASID

Address space number (in decimal) in which the participant is executing

JOBNAME

Participant job name

JOBID

Participant job ID (number)

STEP-NUM

Current step number within the job (if this step accesses a pipe), or the number of the last step that accessed a pipe (if the current step does not access a pipe)

Pipe information

Field

Description

PIPE

Pipe (data set) name

ID

Unique pipe identifier–the first 8 characters of the pipe time stamp

TYPE

Participant type. Possible value is READER WRITER

PIPETYPE

Pipe type

Possible values are:

  • AUTOMATIC–Pipe was defined by using Job Optimizer Pipes rules.

  • MANUAL–Pipe was defined by using subsystem parameters in

  • JCL.STP2STP– Pipe was dynamically defined by Job Optimizer to implement parallel steps processing.

  • INTERNAL–Pipe is used for Job Optimizer Pipes internal purposes.

  • API–Pipe was defined by using the Job Optimizer Pipes API (for future use).

  • BTCHPIPE–Pipe is a BatchPipes-compatible pipe.

LAST-ACT

Time of last operation

STAT

Participant status

Possible values are:

  • AFT-EOF–End-of-file was sent or received by this participant.

  • UNC-CLOS–Close was performed following a previous error (unconditional close).

  • DEFRCLOS–Deferred close was performed.

  • UNC-DALC–Deallocation was performed after a previous error (unconditional deallocation).

  • IMM-ERR–An error in the pipe caused the participant to abend immediately.

  • OFI/DLY–For a writer, the writer writes only to the physical file. For a reader, the reader continues its process regardless of an error in the pipe but abends at the end of the process.

  • IGN-ERR–An error in the pipe was ignored by this participant.

PHASE

Current phase of the pipe participant (for internal use)

PRT-FLG

Participant-related error indications

Possible values are:

  • REJECT–Participant was unable to join the pipe for various reasons.

  • USRERROR–Participant encountered an error.

  • INTABDON–Pipe Handler abended this participant.

  • DISTABND–Participant distributed its error to all other participants. When they receive the error, they should abend.

  • TIMEOUT–Timeout expired, and the participant accepted that indication.

  • PIPEIOE–The pipe I/O Error status was encountered.

  • USRABEND–Participant abended during pipe processing.

PIPE-FLG

Pipe-related error indications

Possible values are:

  • PIPERROR–Pipe is in error.

  • ABENDIMM–Pipe is in error. All participants should immediately abend.

  • ERRDIST–Error was distributed from another participant.

  • TIMEOUT–Timeout expired, and the participant was notified.

  • PEERH–Participant is in error, and the error was handled and distributed to the other participants.

  • PIPEIOE–Pipe I/O error occurred.

  • NO-RDRS–All readers closed before receiving end-of-file.

  • PIPECNCL - Pipe was canceled by the operator by using the F MBOP,CANCEL PIPE = operator command.

PIPE-FL2

Second pipe-related error indications. The possible value is FORCTERM indicating the Job Optimizer Pipes address space was terminated with FORCE option.

STEP-NUM

Step number within the job that allocated the pipe

DDNAME

Name of the DD statement that allocates the pipe

HOME-SYS

Name of the Pipe Home System (PHS). This system is where the pipe is managed.

TIMESTMP

Unique identifier of a pipe. Its value is determined when the first participant allocates the pipe.

FLAG1

Various indications

Possible values are:

  • RMT-PRT–remote participant (this participant runs in a system that is different from the PHS)

  • GLB-PIPE–Global pipe

  • FAST-PIP–Global pipe with only one writer

  • SINGL-RD–fast pipe with only one reader

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments