PRTTRGPGM (Print Trigger Program)

PRTTRGPGM Command syntax diagram

 

Purpose

The Print Trigger Program (PRTTRGPGM) command lists the programs which have been defined as a trigger program for the physical files in the specified library.

This command prints two reports for a library. The first report (Full Report) contains all of the trigger programs associated with files in the specified library. The second report (Changed Report) contains the trigger programs that now appear in the specified library and were not in the library when the PRTTRGPGM command was previously run for the library. If the PRTTRGPGM command was not previously run for the library, there will be no 'Changed Report'. If the command has been previously run for the library but no additional trigger programs are in the specified library, the 'Changed Report' is printed but there are no objects listed. Changing the trigger time, trigger event or trigger update condition for a trigger program will not cause a 'Changed Report' to be generated.

A program is not listed in the 'Changed Report' when the program itself is changed. Therefore, periodically review the entire list of objects that adopt to understand their current function.

Restriction: You must have *ALLOBJ special authority to use this command.

 

Required Parameters

LIB

Specifies the name of the library to search for files that have trigger programs.

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

*ALL: All libraries in the system, including QSYS, are searched.

*ALLUSR: All user libraries are searched.

library-name: Specify the name of the library to be searched.

 

Optional Parameters

CHGRPTONLY

Specifies whether just the changed report should be printed.

*NO: The full and changed reports are printed.

*YES: Only the changed report is printed.

Example for PRTTRGPGM

PRTTRGPGM   LIB(*ALL)

This command searches all files in all libraries and produces the full and changed trigger program reports.

Error messages for PRTTRGPGM

*ESCAPE Messages

CPFB304

User does not have required special authorities.