Defining Structured Infostorage Records › APPLDEF-Infostorage Record Definitions

APPLDEF-Infostorage Record Definitions

This record defines structured infostorage records when your site has unique needs that standard infostorage records do not meet, such as VMO records. CA ACF2 for VM uses the APPLDEF record to validate access to your infostorage records.

Structured infostorage records contain fields that you can list, alter, and validate individually. In contrast, unstructured infostorage records (such as SHIFT records) are composed of lists you can only retrieve and validate, as opposed to accessing individual values in a record.

All infostorage records have keys in the class‑type‑division‑recid form. The APPLDEF record defines the key structure for infostorage records and identifies the Record Structure Block (RSB) that defines the fields and where that RSB resides. A record structure block is a module that tells CA ACF2 for VM how to format and validate an infostorage record. It defines field lengths, validation routines, and other field characteristics.

Fields

CLASS(classcode/classname)

Specifies the class name and code associated with the storage class of this infostorage application. The classcode is the actual numeric character used in the class field of the record key (CA ACF2 for VM uses alphabetic characters). The classname is the name you indicate in the SET subcommand to access these records.

TYPE(typecode/typename)

Specifies the type name and code associated with the storage class of this infostorage application. The typecode is the actual three characters
CA ACF2 for VM uses as the type field of the record key. The typename is the name you indicate in the SET subcommand to access these records.

APPLDIV(divmask)

Specifies the division that groups a set of related infostorage records. You can mask this field to refer to several different records in one infostorage application.

The division mask is the third field of the record key. You can access these records when you enter the SET subcommand. VMO records use this field for the SYSID.

APPLDLEN(maxidlength)

Specifies the maximum length of an application division value. The application division is specified with the APPLDIV field.

DFTDRTN(defaultdivrout)

Indicates the default division routine to invoke if you omit division when you use the SET subcommand to access the records. DFTDRTN can be the name of a CA ACF2 for VM‑supplied routine or the name of a site‑supplied routine.

CA ACF2 for VM supplies two default division routines, ACF00DFT and ACF00SID. Both of these default division routines are shipped as part of the service machine module (ACF2VM). ACF00SID returns the current SYSID (this routine is used for all VMO records). ACF00DFT returns the APPLDIV value if the class and type are unique. There is only one division defined for this APPLID and APPLIDIV is not masked.

RECID(RSBmodule/recidmask,...,RSBmodule/recidmask)

Indicates the record IDs to use with this infostorage application and the record structure block (RSB) associated with those record IDs. The recidmask is the name of the record ID in the record key of these records. You can mask the recidmask so several or all record IDs can use the same RSB. The RSB defines the fields of the records. RSB(modn) is the name of the RSB that defines the fields for the associated record IDs of this infostorage application.

RECIDLEN(maxrecidlen)

Indicates the maximum length of the record ID. Specify the record ID with the RECID field. The default is zero.

SELAUTH(privilege list)

Specifies the privilege field you must have in your logonid to use the SET and LIST subcommands for the infostorage application this APPLDEF record defines. The SET subcommand accesses the infostorage application. The LIST subcommand displays the field values of the infostorage record. Any of the privileges that you can define in the logonid record (SECURITY, ACCOUNT, AUDIT, CONSULT, LEADER, and USER) you can also specify as the SELAUTH value. You can specify more than one privilege. If you specify ALL, a user with any of the standard CA ACF2 for VM logonid privileges can use the SET and LIST subcommands for the defined application. Because the SECURITY privilege allows full access authority, SECURITY in this field lets anyone with the SECURITY privilege issue other ACF subcommands besides SET and LIST. They can also issue INSERT, CHANGE, and DELETE subcommands. Any of the other access privileges, such as USER, let you use the SET and LIST subcommands. If you do not specify a value, the default is SECURITY, AUDIT, ACCOUNT, CONSULT, LEADER.

When you tell CA ACF2 for VM users to bypass INFOLIST validation processing for the infostorage record record defines, it checks the value you specify in the SELAUTH field only to determine the authority required to access the record. Specify this field with caution.

If you need more than one APPLDEF record, you can append a qualifier to the record name in the format APPLDEF(qualifier) to generate a unique record ID (for example, APPLDEF001 or APPLDEF.RSBA). This optional qualifier, together with the record ID name, cannot total more than 16 characters. If you use a period (.) as part of the qualifier string for the record name,
CA ACF2 for VM counts it as a character. For example, because APPLDEF is seven characters, a qualifier can be up to nine characters long. APPLDEF.RSBABCDE is a valid record ID and qualifier. You must create one APPLDEF record for each site‑defined infostorage application.

SHOW Subcommand

In this example, SHOW APPLDEF displays the applications defined to the system.

‑‑ INSTALLATION DEFINED STRUCTURED INFOSTORAGE APPLICATIONS ‑‑
 
VMO RECORD (SYSID / RECID): 2ND LEVEL / APPLDEF.1
CLASS(SHORT / LONG):    1     / OUROWN
TYPE (SHORT / LONG):    VAA    / VAA
SELECTION AUTHORIZATION:  SECURITY, ACCOUNT, AUDIT, CONSULT, LEADER
DEFAULT DIVISION ROUTINE:  ACFOOSID
ACTIVE DIVISION:      *********
ASSOCIATED RSB / RECORD ID: TSTRSBMS / MESSAGE
              TSTRSB01 / TEST01
              TSTRSBMS / TEST02
 
VMO RECORD (SYSID / RECID): 2NDLEVEL / APPLDEF
CLASS (SHORT / LONG):    2    / TSTAPPL
TYPE (SHORT / LONG):    TST   / TESTING
SELECTION AUTHORIZATION:  SECURITY, ACCOUNT, AUDIT, CONSULT, LEADER
DEFAULT DIVISION ROUTINE:  ACF00SID
ACTIVE DIVISION:      ********
ASSOCIATED RSB / RECORD ID: TSTRSBMS / TEST02

If you have not defined any records, the SHOW APPLDEF command displays this title:

‑‑NO APPLICATION DEFINITIONS EXIST ON THIS SYSTEM‑‑