Customizing the CA Ideal Environment › Customizing the CA Ideal Options Block Using IDOPTSCB

Customizing the CA Ideal Options Block Using IDOPTSCB

To change the CA Ideal Options, you must use the IDOPTSCB macro to reassemble the source member IDOPTS, and then link edit @IIDOPTS to implement the changes. (In CICS, you must recycle CICS to implement the changes.) The CA Ideal install job for custom assemblies contains a model of the IDOPTS table that can be used to modify the distributed default values. It also contains JCL that can be used to assemble and link edit the IDOPTS table into @IIDOPTS.

For VSE, the IDOPTS.A book, in the distribution library, contains a model of the IDOPTS table that can be used to modify the distributed default values. The IDOPTASM.Z book, in the distribution library, is the sample for assembling and link editing the IDOPTS table into phase @IIDOPTS.

The IDOPTSCB macro with an explanation of all the parameters that are applicable to FUNC=START is shown following. See Maintaining Authorizations in this chapter for information about parameters specified for FUNC=ATZ. The IDOPTSCB macro contains default values as shown.

IDOPTSCB FUNC=,                                                             X
	ATZEXIT=,              Optional Global Auth Exit Name                X
	COMMAND=,              Functional Authorization Name                 X
	DB2PLAN=IDP140DV,      Default DB2 Application Plan                  X
	DB2SYS=DSN,            Default DB2 Subsystem ID                      X
	DFLTUSR=NONE,          Default IDEAL Signon User-ID                  X
	DVWLIB=IDDVW,          Dataview Library                              X
	IDENT=IDEAL,           Product Panel Identifier                      X
	LEVEL=,                Minimum Level Of Authorization                X
	LMTBLD=DD,             Build Load Module Table?                      X
	MEMLIB=IDDAT,          Member Library                                X
	OBJLIB=IDXXXOBJ,       IDEAL Object Library Default                  X
	PLALIB=IDDVW,          Application Plan Library                      X
	PLTID=IDPI,            Transaction ID For PLT                        X
	PLTLOAD=NO,            Load Modules At PLT                           X
	PNLLIB=IDXXXPNL,       IDEAL Panel Library Default                   X
	PSWDIS=VISIBLE,        VISIBLE|INVISIBLE  In DIS USR                 X
	SECPRFX=$I,            Security Prefix For Resource Chks             X
	SORTLIB=,              VLS libs for sort work areas                  X
	SORTMS=IDSORTMS,       TRAN ID For Build Messages                    X
	SORTSZ=200704,         TRAN ID For Build  Size Parm                  X
	SORTWK=IDSORT01,       Batch Report Sort Work Area                   X
	SORTWP=,               Batch Report DOS WORK= Parm                   X
	SORTRC=10000000,       On-line Sort Max Number Recs                  X
	SRCLIB=IDXXXSRC,       IDEAL Source Library Default                  X
	TYPE=DC,                                                             X
	UIDCHK=YES             USER-ID Integrity Check Option

At a minimum, you must code the IDOPTSCB macro twice with FUNC=START and FUNC=END. To alter the command authorization levels, code one or more FUNC=ATZ macros.

FUNC=

• START-Creates the beginning of the IDOPTSCB table and the default command authorization levels. It must be the first in a series of IDOPTSCB macros and can be coded only once.
• ATZ-Updates any corresponding entry in the table of command (or functional) authorizations. It is optional and should only be coded when you need to modify the default authorization level for a command (or Functional Authorization) or to invoke a user coded exit routine.

  It must be preceded by a FUNC=START and must not follow a FUNC=END. It can be coded any number of times.

• On the FUNC=ATZ the following parameter is required:

  COMMAND=

• The following parameters are optional:
  • ATZEXIT=
  • LEVEL=

  Note: The preceding parameters for changing the authorization levels are described in detail in the Maintaining Authorizations section in this chapter.

• END- Completes the table. It must be preceded by a FUNC=START and all FUNC=ATZ (if any). There are no other parameters for FUNC=END.
• HELP-Generates a print of the IDOPTSCB macro descriptions.
• ATZEXIT=Specifies the name of an optional user-coded exit module to receive control during the authorization processing of the functions listed under COMMAND=.

  When coded with FUNC=START, it becomes the exit for all listed COMMANDS. However when coded with FUNC=ATZ, the module is invoked only for that COMMAND. The FUNC=ATZ takes precedence over FUNC=START.

  ATZEXIT must be one to eight characters and follow normal load module naming conventions. See the section titled Maintaining Authorizations in this chapter for further details.

• COMMAND= Specifies the Functional Authorization to update. You must code it with FUNC=ATZ. See the Maintaining Authorizations section in this chapter.
• DB2PLAN=For sites with DB2 support, this defines the default application plan name CA Ideal uses when no other name is available. This can be any valid DB2 plan name. The default is release specific (IDPrrrDV).
• DB2SYS=For sites with DB2 support, this defines the default Subsystem ID CA Ideal uses to connect to DB2. This can be any valid DB2 Subsystem ID. It is padded with spaces to a length of four characters. The default is DSN.
• DFLTUSR=A three-character short ID of an existing CA Ideal user definition. This parameter specifies a default user ID for CA Ideal signons. During signon, if CA Ideal does not find a dictionary entity occurrence or alias for the supplied user ID, another signon attempt is then made with this three-character short ID. When NONE is specified, no further attempt is done if the original signon fails. The default is NONE.
• DVWLIB=A one- to eight-character name for the CA Ideal Dataview library. The default is IDDVW.
• IDENT=A five-character value that is placed on all of CA Ideal's product panels. Panels of the Inter-Product Components do not use this value nor do customer application panels. If the value CUA is supplied, CA Ideal uses the internal four-character panel name of each panel displayed. The default is IDEAL.
• LEVEL=Specifies the minimum level of authorization required for a given COMMAND=. See the section titled Maintaining Authorizations in this chapter for further explanations.
• LMTBLD= Specifies how the in-core load module table (LMT) is built. The default, DD, specifies that the LMT is built using @ILMLIST and the dictionary module entries. NO specifies that CA Ideal only processes @ILMLIST entries for this region. For more information, see the “Module Format for Programs and Panels” chapter.
• MEMLIB=A one- to eight-character name for the CA Ideal Member Library. The default is IDDAT.
• OBJLIB= A one- to eight-character name for the CA Ideal PDL Object library that appears on the System fill-in panel. The default is IDXXXOBJ.
• PNLLIB= A 1-8 character name for the CA Ideal PDF Panel library that appears on the System fill-in panel. The default is IDXXXPNL.
• PLALIB=A one- to eight-character name for the CA Ideal DB2 Application Plans library. The default is IDDVW.
• PLTID= Identifies the CICS transaction that initializes a control table to manage the optional use of load modules for PDL programs. The default is IDPI.
• PLTLOAD= (CICS only) A YES value indicates user load modules are loaded during the building of the LMT. A NO value bypasses the loading of the modules during the building of the LMT. The verification is done at the time each module is first used. The default is NO.
• PRINT= Controls the printing of the resulting assembler listing. You can use any value supported by the assembler (for example, ON, OFF, GEN, NOGEN). The default is ON.
• PSWDIS= Controls an option to make the PASSWORD field of the User Definition fill-in invisible. The keywords supported are VISIBLE and INVISIBLE. Specifying INVISIBLE also results in an additional field on the User Definition fill-in as a means of verifying the password entered. The default is INVISIBLE. See Creating a CA Ideal User Definition in this guide for more information.
• SECPRFX= A two-character prefix for the CA Ideal security resource checks. This prefix is used during signon to determine whether the user can sign on to CA Ideal. It is also used in front of all resource entity names that CA Ideal performs resource checks on. The default is $I.
• SORTLIB= Specifies the VLS library that contains members used as sort work areas for on-line sorted reports. You can use any one- to eight-character VLS library name. If a value is not specified, the value supplied for MEMLIB is used.
• SORTMS= (z/OS only) A one- to eight-character name for batch sort utility messages for compiles with cross‑reference and programs run with sorted reports. The default is IDSORTMS.
• SORTRC= Maximum number of records that can be sorted on-line. If this value is exceeded, a runtime error occurs before the sort begins. The default is 10000000.
• SORTSZ= Core size parameter for the execution of a sort report. The default is 200704.
• SORTWK= A one- to eight-character name for the batch report sort work area. The default is IDSORT01.
• SORTWP= For DOS only, you can specify a value for the SORT WORK= parameter.
• SRCLIB= A one- to eight-character name for the PDL Source library that appears on the System fill-in panel. The default is IDXXXSRC.
• UIDCHK= When NO, this parameter enables the signon user ID to be different from either the CA Ideal person name or short ID that is found in the dictionary. This associates different operator IDs with a common user ID for group signons. It also lets a security ID be different from a CA Ideal person in a security signon. A value of YES requires that the user ID match either the person name or short ID of an existing CA Ideal user. The default is YES.

Example

IDOPTS CSECT

    IDOPTSCB  FUNC=START,                              X
    PSWDIS=INVISIBLE,                                  X
    TYPE=DC
    IDOPTSCB  FUNC=ATZ,COMMAND=RUN,                    X
    ATZEXIT=RUNCHECK
    IDOPTSCB  FUNC=ATZ,COMMAND=CREATE-PGM,             X
    LEVEL=UPDATE
    IDOPTSCB  FUNC=ATZ,COMMAND=DEQUEUE,                X
    LEVEL=DISABLE
    IDOPTSCB  FUNC=ATZ,COMMAND=COPY-PGM-ACR-SYS,       X
    LEVEL=(UPDATE,CONTROL),                            X
    ATZEXIT=MYPROG
    IDOPTSCB  FUNC=END
END