COZZI-Chg Print Monitor Status (CHGPRTMON)

The Change Print Monitor Status (CHGPRTMON) command modifies the QIBM_NOTIFY_CRTSPLF environment variable so that the print monitor can monitor SPOOL files created by this job or by the system. Normally this command is used to add your job to an existing/active print monitor. For example, if STRPRTMON has been run with LEVEL(*JOB) then use the CHGPRTMON command to include your job (the job running the CHGPRTMON command) in print monitoring. NOTE: To end print monitoring, use the ENDPRTMON command.

Parameters

Keyword	Description	Choices	Notes
OPTION	Start or end print monitoring	START, END	Required, Positional 1
LEVEL	Monitor Level	SYS, JOB	Optional, Positional 2
DTAQ	Data Queue for Monitor	Single values: ACTIVE Other values: Qualified object name*	Optional, Positional 3
	Qualifier 1: Data Queue for Monitor	Name, *COZTOOLS
	Qualifier 2: Library	Name, QGPL
USRDTAARA	Print Monitor Data Area	Single values: NONE Other values: Qualified object name*	Optional, Positional 4
	Qualifier 1: Print Monitor Data Area	Name, QPRTMONUSR, *DFT
	Qualifier 2: Library	Name, *LIBL

Top

Start/End Print Monitoring (OPTION)

Specifies whether to start or end print monitoring for the current job or for the entire system. OPTION(*START) starts print monitoring. OPTION(*END) ends print monitoring.

Required parameter

*START: Starts print monitoring for this job by adding the QIBM_NOTIFY_CRTSPLF environment variable to the job. If LEVEL(*SYS) is specified, then this job and the system-level environment variable are changed. This will cause the active print monitor to use the new data queue upon the next cycle. Meaning, after it receives the current entry or times-out reading it from the previously specified data queue, the monitor will automatically change to the new data queue name specified on the DTAQ parameter of this command, upon the next cycle.
*END: Ends print monitoring for this job by removing the QIBM_NOTIFY_CRTSPLF environment variable from the job. If LEVEL(*SYS) is specified, then the system-level environment variable is also removed. This causes the active print monitor to end upon the next cycle. Using OPTION(*END) has the same results as issuing the ENDPRTMON command.

Monitor Level (LEVEL)

Specify the environment level (*JOB or *SYS) to add the QIBM_NOTIFY_CRTSPLF environment variable and include the name of the data queue specified on the DTAQ parameter.

*JOB: The QIBM_NOTIFY_CRTSPLF environment variable is added or changed for this job only. If an active print monitor is running, then all new SPOOL files created from this point on shall be included in the print monitor process.
*SYS: The QIBM_NOTIFY_CRTSPLF environment variable is added or changed at the system level. This means all new jobs entering the system shall be included in print monitoring--a copy of this environment variable will be inserted into their job automatically by the system.

Data Queue for Monitor (DTAQ)

Print monitoring uses a data queue that the system updates. When a new SPOOL file is created in a job, and that job includes the QIBM_NOTIFY_CRTSPLF environment variable, an entry is placed on the data queue associated with that environment variable. This parameter is used to modify that setting for your job when LEVEL(*JOB) is specified, or for the entire system when LEVEL(*SYS) is specified. NOTE: To end print monitoring system-wide, use the ENDPRTMON command.

Data Queue for Monitor

*ACTIVE: The active Print Monitor data queue is used. The system-level QIBM_NOTIFY_CRTSPLF environment variable is retrieved and the *DTAQ stored in it is used as the data queue for the job running the CHGPRTMON command. NOTE: This option is only valid when OPTION(*START) and LEVEL(*JOB) are specified. This option is not valid when LEVEL(*SYS) is specified.
*COZTOOLS: The COZPRTMON data queue in QGPL is the default *DTAQ used by the STRPRTMON command. The *COZTOOLS option changes the job or system so that it now uses the COZPRTMON data queue in QGPL.
name: Specify any data queue name that has been or will be specified on the STRPRTMON command. If the data queue does not exist, monitoring obviously cannot add entries to it when a new SPOOL file is created. The STRPRTMON command will create the data queue specified on the DTAQ parameter of that command.