Print OptiConnect Jobs (PRTOPCJOB)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Print OptiConnect Jobs (PRTOPCJOB) command writes a list of OptiConnect jobs and tasks to a spooled output file or to a database output file. An OptiConnect job or task is a job or task that has one or more OptiConnect conversations attached.

Top

Parameters

Keyword Description Choices Notes
JOB Job name Qualified object name Optional
Qualifier 1: Job name Generic name, name, *ALL
Qualifier 2: User Generic name, name, *ALL
RMTJOB Remote job name Qualified object name Optional
Qualifier 1: Remote job name Generic name, name, *ALL
Qualifier 2: User Generic name, name, *ALL
RMTSYS Remote system Generic name, name, *ALL Optional
OUTPUT Output *PRINT, *OUTFILE Optional
OUTFILE File to receive output Qualified object name Optional
Qualifier 1: File to receive output Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member options Element list Optional
Element 1: Member to receive output Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD
Top

Job name (JOB)

Specifies the name of the OptiConnect job or task on the local system.

Qualifier 1: Job name

*ALL
All OptiConnect job and task names are selected.
generic-name
Specify the generic name of the OptiConnect job or task on the local system.
name
Specify the name of the OptiConnect job or task on the local system.

Qualifier 2: User

*ALL
All user names are selected.
generic-name
Specify the generic name of the user of the OptiConnect job on the local system.
name
Specify the name of the user of the OptiConnect job on the local system.
Top

Remote job name (RMTJOB)

Specifies the name of the OptiConnect job or task on the remote system.

Qualifier 1: Remote job name

*ALL
All OptiConnect job and task names are selected.
generic-name
Specify the generic name of the OptiConnect job or task on the remote system.
name
Specify the name of the OptiConnect job or task on the remote system.

Qualifier 2: User

*ALL
All user names are selected.
generic-name
Specify the generic name of the user of the OptiConnect job on the remote system.
name
Specify the name of the user of the OptiConnect job on the remote system.
Top

Remote system (RMTSYS)

Specifies the name of the remote system.

*ALL
All systems are selected.
generic-name
Specify the generic name of the remote system.
name
Specify the name of the remote system.
Top

Output (OUTPUT)

Specifies where the output from the command is sent.

*PRINT
The output is printed with the job's spooled output.
*OUTFILE
The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.
Top

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualifier 1: File to receive output

name
Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL
The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
*CURLIB
The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the name of the library to be searched.

Note: If a new file is created, the system uses the IBM-supplied file QAOPCJOB in library QSOC with format name QYYJOB as a model.

Top

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST
The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
name
Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE
The system clears the existing member and adds the new records.
*ADD
The system adds the new records to the end of the existing records.
Top

Examples

Example 1: Print All OptiConnect Jobs

PRTOPCJOB

This command prints all OptiConnect jobs and tasks.

Example 2: List OptiConnect Jobs in an Outfile

PRTOPCJOB   RMTJOB(SOCA*)  RMTSYS(SYSTEMA)
            OUTPUT(*OUTFILE)  OUTFILE(QGPL/OPCJOBS)

This command writes a list of all OptiConnect agent jobs that are running on remote system SYSTEMA to an outfile named OPCJOBS in library QGPL.

Top

Error messages

*ESCAPE Messages

CPF9860
Error occurred during output file processing.
Top