Keywords › PRIVPGM Keyword—Specify Programs in Control

PRIVPGM Keyword—Specify Programs in Control

Valid on z/OS.

Use the PRIVPGM keyword to specify the full names of the programs in control when a resource is accessed. A privileged program specification restricts the use of a resource to a control path.

This keyword has the following format:

TSS PERMIT(acid) resource(prefix(es)) PRIVPGM(program)

Prefix length

One to eight characters

Capacity of list

One to five program names

(DSNAMEs only) PRIVPGM may be combined with LIBRARY to specify the library in which the privileged program must reside. If LIBRARY is not specified, the privileged program must come from the link pack area (LPA) or from a library in the link list.

The privileged program specified in the PERMIT function must be executed via the following JCL keyword:

EXEC PGM=program

or via a program executed through LINK, LOAD, ATTACH, or XCTL.

Technically, the program must be associated with the top‑most or bottom‑most PRB.

This keyword is used with:

• With the PERMIT command
• The ACID types User, Profile, DCA, VCA, ZCA, LSCA, SCA, MSCA, and ALL
• No specific authority. Resource(XAUTH) authority is required to specify PRIVPGM for resources.

Examples: PRIVPGM keyword

This example permits access to SMF data sets SYS1.MANX and SYS1.MANY specifically through a link‑listed program:

TSS PERMIT(SYS92) ACCESS(CONTROL)
                  DSNAME(SYS1.MAN+)
                  PRIVPGM(SMFMNGR)

This example permits access to a personnel data set, but only if program PRSP60 is used and is loaded from a specific library:

TSS PERMIT(PAY100K) DSNAME(PERS.*.MASTER)
                    PRIVPGM(PRSP60)
                    LIBRARY(PERS.LOADLIB)

This example permits access to the same personnel data set, but allow any program beginning with the characters PRSP:

TSS PERMIT(PAY100K) DSNAME(PERS.*.MASTER)
                    PRIVPGM(PRSP(G))

This example permits access to a CICS file, but only if the CICS program in control is PCC505:

TSS PERMIT(CLK505P) FCT(PARTS)
                    PRIVPGM(PCC505)