Structured Infostorage Record Definitions (APPLDEF)

The Structured Infostorage Record Definitions (APPLDEF) record lets you define your own structured infostorage records. Define the APPLDEF record when your site has unique requirements that a standard structured infostorage records, such as GSO TSO records. CA ACF2 uses the APPLDEF record to validate access to your structured infostorage records.
acf2src
The Structured Infostorage Record Definitions (APPLDEF) record lets you define your own structured infostorage records. Define the APPLDEF record when your site has unique requirements that a standard structured infostorage records, such as GSO TSO records. CA ACF2 uses the APPLDEF record to validate access to your structured infostorage records.
The APPLDEF record defines the key structure for structured infostorage records. APPLDEF identifies the record structure block (RSB) used to define the fields and where that RSB resides. A record structure block is a module that tells CA ACF2 how to format and validate a structured infostorage record. The record defines field lengths, validation routines, and other field characteristics.
Popular uses for structured infostorage records include:
  • Operator Identification Card Support
  • Extended user authentication (EUA) support
  • VTAM common sign-on product support
For additional information on structured and unstructured infostorage records, see Create Structured Infostorage Records.
The APPLDEF record is optional. If your site plans to use its own structured infostorage applications, you must create one APPLDEF record for each application. Only one APPLDEF record is required for each class and type. If more than one GSO APPLDEF record is retained for the same class and type of resource, the last record read determines which record structure block CA ACF2 uses.
The following lists the record format and field descriptions for APPLDEF:
APPLDEF
qual
APPLDIV(
divmask
) APPLDLEN(
maxdivisionidlength
)
BLANKS
|NOBLANKS CLASS(
classcode|classname
) COMPILE|
NOCOMPILE
DFTDRTN(
defaultdivisionroutine
) EXTCOMP
NEXTCOMP
RECID(
RSBmodule|recidmask,...,RSBmodule|recidmask
) RECIDLEN(
maxrecidlength
) RSBLIB(
rsblib
) SELAUTH(
privilegelist
) TYPE(
typecode|typename
)
  • APPLDIV(
    divmask
    )
    Specifies the division that is used to group a set of related infostorage records. You can mask this field to refer to several different records in one structured infostorage application. For example, you can create an APPLDEF record that applies to all releases of IMS by specifying APPLDIV(-). The division mask is the third field of the record key. You can use it to access these records when you specify the SET subcommand.
    If you do not specify a value for APPLDIV, you cannot specify DIVISION for any of the ACF subcommands.
  • APPLDLEN(
    maxdivisionidlength
    )
    Specifies the maximum length of an application division value. The application division is specified with the APPLDIV field.
  • BLANKS
    |NOBLANKS
    Specifies whether embedded blanks can be used in the record IDs for this application.
  • CLASS(
    classcode/classname
    )
    Specifies the class name and code to be associated with the storage class of this structured infostorage application. The
    classcode
    is the actual numeric character that is used in the class field of the record key. (Alphabetic characters are reserved for use by CA ACF2.) The classname is the name that a user indicates on the SET subcommand of the ACF command to access these records.
  • COMPILE|
    NOCOMPILE
    Designates whether the records stored under the infostorage class and type that is defined by the APPLDEF definition are not standard CA ACF2 structured infostorage records. Instead they are special internal-format compiled records. (CA-reserved control)
    Default:
    NOCOMPILE. The records are standard CA ACF2 structured infostorage records. NOCOMPILE should be used unless otherwise instructed by way of product documentation, sample product installation jobs, or using other means of communication.
  • DFTDRTN(
    defaultdivisionroutine
    )
    Indicates the default division routine to invoke if you omit division when you use the SET subcommand to access the records.
    Default:
    ACF00DFT, which is the standard default division routine.
  • EXTCOMP|
    NEXTCOMP
    Designates whether the records stored under the infostorage class and type that is defined by this APPLDEF definition are not standard structured infostorage records. Instead they are special internal-format compiled records. (CA-reserved control)
    Default:
    NEXTCOMP, which is the standard structured infostorage records. The default should be used unless instructed by way of product documentation, sample product installation jobs, or using other means of communication.
  • RECID(
    RSBmodule/recidmask,...,RSBmodule|recidmask
    )
    Indicates the record IDs for use with this structured infostorage application and the record structure block (RSB) to be associated with those record IDs. The recidmask is the name of the record ID that is used in the record key of these records. The recidmask is maskable, so several or all record IDs can use the same RSB. The RSB defines the fields of the records. For more information about creating an RSB, see Special Usage Considerations. RSBmodule is the name of the RSB that defines the fields for the associated record IDs of this structured infostorage application.
  • RECIDLEN(
    maxrecidlength
    )
    Indicates the maximum length of the record ID. The record ID is specified with the RECID field.
    Default:
    Zero.
  • RSBLIB(
    rsblib
    )
    Indicates the library into which the RSB has been link edited. The value that is specified for RSBLIB should be a fully qualified data set name (or a data set name ALIAS). CA ACF2 searches the Link Pack Area (LPA) for the RSB. If the RSB is not found in the LPA, CA ACF2 loads the RSB from the RSBLIB.
    Default:
    Null, which indicates to CA ACF2 that the RSB can be found in the LPA.
  • SELAUTH(
    privilegelist
    )
    Specifies the privilege users must have to use the SET and LIST subcommands for the structured infostorage application that is defined by this APPLDEF record. The SET subcommand lets users access the structured infostorage application. The LIST subcommand lets users display the field values of the structured infostorage record. You can specify any of the CA ACF2 privileges in the logonid record (SECURITY, ACCOUNT, AUDIT, CONSULT, LEADER, and USER). You can specify more than one privilege.
    If you specify ALL, a user with any of the standard logonid privilege fields can use the SET and LIST subcommands for the defined application. Because the SECURITY privilege permits full access authority, specifying SECURITY in this field lets the logonid issue the INSERT, CHANGE, and DELETE subcommands as well. Any of the other access privileges, such as AUDIT, allow the use of the SET and LIST subcommands. If no value is specified, the default is SECURITY, AUDIT, ACCOUNT, CONSULT, and LEADER.
    When CA ACF2 bypasses INFOLIST validation processing, it checks the value that you specify in the SELAUTH field only to determine the authority that is required to access the record. Specify this field with care.
    For information about INFOLIST bypass processing, see Special Usage Considerations.
  • TYPE(
    typecode/typename
    )
    Specifies the type name and code to be associated with the storage class of this structured infostorage application. The type code is the actual three characters that are used as the type field of the record key. The type name is the name that a user indicates on the SET subcommand of the ACF command to access these records.
Creating Multiple GSO APPLDEF Records
If you need more than one APPLDEF record, you can append a qualifier to the record name in the format APPLDEF
qual
to generate a unique record ID. For example, APPLDEF001 or APPLDEF.RSBA. This optional qualifier can be up to nine characters, and must immediately follow the characters APPLDEF. If you use a period (.) as part of the qualifier string for the record name, it is counted as one of the nine available characters.
Displaying GSO APPLDEF Record Information
SHOW APPLDEF displays the applications that are defined to the system.
-- INSTALLATION DEFINED STRUCTURED INFOSTORAGE APPLICATIONS -- CLASS (SHORT / LONG): I / IDENTITY TYPE (SHORT / LONG): AUT / AUTHSUP SELECTION AUTHORIZATION: SECURITY, ACCOUNT, AUDIT, CONSULT, LEADER DEFAULT DIVISION ROUTINE: ACF00DFT ACTIVE DIVISION: AUTHSUP3 ASSOCIATED RSB / RECORD ID: ACF2RSB1 / ******** CLASS (SHORT / LONG): I / IDENTITY TYPE (SHORT / LONG): AUT / AUTHSUP SELECTION AUTHORIZATION: SECURITY, ACCOUNT DEFAULT DIVISION ROUTINE: ACF00DFT ACTIVE DIVISION: AUTHSUP5 ASSOCIATED RSB / RECORD ID: ACF2RSB2 / ********
If you have not defined any GSO APPLDEF records, the SHOW APPLDEF subcommand displays the title:
--NO APPLICATION DEFINITIONS EXIST ON THIS SYSTEM--
Example
The following APPLDEF record example is coded for extended user authentication use:
APPLDEF.EUA1 CLASS(I/IDENTITY) TYPE(AUT/AUTH) APPLDIV(EUA1) APPLDLEN(8) DFTDRTN(ACF00DFT) RECID(EUA1MOD/-) RSBLIB(RSB.LOADLIB) RECIDLEN(8) SELAUTH(SECURITY,ACCOUNT,AUDIT,CONSULT,LEADER)
This APPLDEF record indicates that the class and type of this record are IDENTITY and AUTH (or AUT). The division that is used for this exit is called EUA1, and the maximum length of the division is eight. The ACF00DFT routine is used as the default division routine. All records that are used by this exit are mapped by one record structure block (described in the following) named EUA1MOD, which is found in RSB.LOADLIB. The maximum record name length is eight characters. You must have SECURITY, ACCOUNT, AUDIT, CONSULT, or LEADER authority to set an ACF command session to IDENTITY(AUTH) to process these records. SELAUTH is only in force if the RSB defers to it; otherwise, you use the values that are specified in the infolist parameter in the OPTS record.
To access these records with the ACF command, the installation security officer (ISO) or administrator can enter the long form of the SET subcommand:
SET IDENTITY(AUTH) DIVISION(EUA1)
Or the short form:
T I(AUT) DIV(EUA1)