Statements and parameters for IPCSPRnn

Multiple keywords are no longer functional: As of z/OS® V1R11, the only functional keywords are LINELENGTH and PAGESIZE. The DSD, NODSD, PDR, NOPDR, PROBIDPREFIX, SYSTEM, GROUP, ADMINAUTHORITY, and DELETEAUTHORITY keywords continue to be parsed but are ignored by IPCS when IPCSPRnn is processed.

ADMINAUTHORITY(userid-list)

Specifies the TSO/E user IDs of the persons that are to have IPCS administrative authority. userid is one to eight alphanumeric characters.

The owners of the specified TSO/E user IDs have the same authority that a problem owner has, but they have that authority over all problems in the problem directory.

Specifying administrators does not affect the privileges of problem owners. Owners can still modify and delete problems that they own.

Specifying persons with administrative authority provides centralized control over all problems that are defined to IPCS. Administrators can assign and reassign problem owners, access a problem when the owner is unavailable, update problems when their attributes change, correct attributes that were incorrectly specified, and so forth.

This parameter is optional.

If not specified, no one has administrative authority for the installation.

If specified, it is a list whose entries are separated by one or more blanks, commas, or horizontal tabulation characters (X'05'). Each entry in the list can specify the user ID of an administrator or can specify an inclusive range of user IDs.

Example: The following example authorizes the person with user ID THEBOSS plus all persons with user IDs that begin with the letters ADMIN as administrators.

ADMINAUTHORITY(THEBOSS,ADMIN:ADMIN)

DELETEAUTHORITY(userid-list)

Specifies the TSO/E user IDs of the persons with IPCS delete authority. The owners of the specified TSO/E user IDs are the only persons who can delete problems. Specifying persons with delete authority diminishes the privileges of a problem owner and the person with administrative authority. They can modify problems but cannot delete them.

Specifying persons with delete authority provides centralized control over removing problems from IPCS. When a problem is deleted, all the accumulated information about it is lost. By designating persons who can delete problems, you can help prevent the inadvertent loss of such information.

This parameter is optional.

If specified, only the designated person can use the DELPROB subcommand of IPCS. Problem owners cannot use the DELPROB subcommand nor can the person that is designated with the ADMINAUTHORITY parameter (if the user ID specified is the different).

If this parameter is not specified, problem owners and the person that is specified with the ADMINAUTHORITY parameter can use the DELPROB subcommand.

DSD(datasetname)

Specifies the data set name of the IPCS data set directory. datasetname must be fully qualified and need not be in single quotation marks. IPCS appends nothing to either end of the specified name. This parameter is required. Without it, IPCS ends.

GROUP(group-id)

Specifies the default group identifier. group-id is one to eight alphanumeric characters. The ADDPROB subcommand of IPCS uses this value if you omit the GROUP keyword on the subcommand. This parameter is optional. The default group-id is blank.

LINELENGTH(value)

Specifies the default record length (LRECL) for the IPCS print output data set. value is a two- or three- decimal digit from 83 through 255. This parameter is optional.

If you do not specify an LRECL for the print output data set and if it is not specified in the session parameters, the default is 137.

Value range: 83-255

Default: 137

NODSD

Suppresses the use of problem and data management. This option requires the specification of the NOPDR option.

Default: NODSD

NOPDR

Suppresses the use of problem and data set management. This option requires the specification of the NODSD option.

Default: NOPDR

PAGESIZE(value)

Specifies the default number of lines per page for the IPCS print output data set. value is a decimal number that ranges from 3 through 2³¹-1. This parameter is optional. If you do not specify it, the default is 60.

PAGESIZE values should correspond with the number of lines that will fit on the forms that are typically used at your installation.

Default: 60

PDR(datasetname)

Specifies the data set name of the IPCS problem directory. datasetname must be fully qualified and need not be in single quotation marks. IPCS appends nothing to either end of the specified name. This parameter is required. Without it, IPCS ends.

PROBIDPREFIX(prefix)

Specifies the three-character value that is used to form a problem identifier where prefix is three alphanumeric characters. IPCS uses this prefix whenever an IPCS subcommand displays or prints a problem identifier. To form the complete problem identifier, IPCS concatenates a 5-digit decimal number to this prefix.

If the DSD(datasetname) and PDR(datasetname) parameters are specified, PROBIDPREFIX(prefix) is a required parameter. Without it, IPCS ends.

SYSTEM(system-id)

Specifies the default system identifier where system-id is one to eight alphanumeric characters. The ADDPROB subcommand of IPCS uses this value if you omit the SYSTEM keyword on that subcommand. This parameter is optional. The default is blank.