Appendix G. System Definition/Customization/Administration; Authorized Rexx/Cics Commands/Authorized Command Options; System Profile Exec; Authorized Rexx/Cics Vse Librarian Sublibraries - IBM SC34-5764-01 Manual

Appendix G. System Definition/Customization/Administration

This appendix discusses the system definition, customization, and administration of REXX/CICS.

Authorized REXX/CICS Commands/Authorized Command Options

Several REXX/CICS commands, or command options, are identified as being authorized. An authorized
REXX/CICS command can only be executed if:
v The user ID issuing the exec is an authorized REXX/CICS user. Authorized users are defined by the
AUTHUSER command.
v The exec was loaded from a REXX/CICS authorized sublibrary. An authorized sublibrary is a VSE
Librarian sublibrary specified on a SETSYS AUTHCLIB or a SETSYS AUTHELIB command.
This rule applies regardless of whether or not the exec attempting the command was issued by an
authorized exec.

System Profile Exec

A system profile exec, named CICSTART, is issued before the first user exec is run after a CICS system
restart. Usually, the system profile exec contains system customization commands, authorized sublibrary
definitions, authorized user definitions, and authorized command definitions that must reside in an
authorized REXX/CICS sublibrary.
The CICSTART exec is loaded from the first occurrence of the member CICSTART.PROC in the LIBDEF
PROC search chain for the CICS partition.
Note: The sublibrary in which the member CICSTART.PROC is found is treated as the initial authorized
REXX/CICS sublibrary. This can then be changed using the SETSYS AUTHCLIB and SETSYS
AUTHELIB commands.

Authorized REXX/CICS VSE Librarian sublibraries

The VSE Librarian sublibraries specified on the SETSYS AUTHCLIB and SETSYS AUTHELIB commands
are considered REXX/CICS authorized sublibraries. If multiple sublibraries are specified, they are searched
in the order specified in the command.
The sublibrary in the LIBDEF PROC search chain for the CICS partition containing the member
CICSTART.PROC used to initialize REXX/CICS is treated as the initial authorized sublibrary. This can then
be changed by using the SETSYS AUTHCLIB and SETSYS AUTHELIB commands.
Notes:
1. Users can cause dynamic allocation of their own VSE Librarian sublibraries by using the REXX/CICS
PATH command.
2. Any user can run an exec from a sublibrary specified in the SETSYS AUTHELIB command and any
exec loaded from one of these sublibraries can use REXX/CICS authorized commands.

Defining Authorized Users

Users may be specified as authorized by the AUTHUSER command. It is recommended that all
AUTHUSER commands be placed in the CICSTART exec, or in an exec issued from within the CICSTART
exec.
© Copyright IBM Corp. 1992, 2009
417