Activating and Changing Entry Records

Maintaining Entry Source and Source Group Records › Activating and Changing Entry Records

Activating and Changing Entry Records

To activate a newly created or modified entry record, issue the ACFSERVE RELOAD XREF command. This command dynamically updates the source entry records cross‑reference table. If you do not use this command, any changes to this cross‑reference table are not effective until you IPL the service machine. For details, see the “Defining Structured Infostorage Records” chapter.

Changing Entry Records

Use the CHANGE subcommand under the ENTRY setting to add sources to a source group or update existing source groups. The syntax for this CHANGE subcommand is:

       {      *              }
CHange { recordname          }
       { LIKE(recmask)       }
 
       { [ OLDDATA(olddata) ]}
       { [ NEWDATA(newdata) ]}
       { [ VERDATA(verdata) ]}
 
         [ DSN(dsn)         ]
         [ CLEAR            ]

*: Indicates you want to change the last record of this type processed since establishing the ENTRY setting with a specific type‑code.
recordname: Specifies the one‑ to eight‑character entry record name record to be changed.
LIKE(recmask): Selects only entry records that match the specified mask. (Never use the same record name for an SGP entry record and SRC entry record.)
OLDDATA(olddata): Specifies old data information.
VERDATA(verdata): Specifies verification data.
NEWDATA(newdata): Specifies new data.
DSN(dsn): Specifies a filename for authorization control. Any user that can access this file can modify the entry record.
CLEAR: Clears an existing entry record of all data items. It eliminates all data items (except for DSN) before adding the NEWDATA operand data.

Examples

You must specify at least one of the following operands: CLEAR, DSN, NEWDATA, OLDDATA, VERDATA. You can specify more than one.

NEWDATA adds an item to the list:
```
CHANGE RM433 NEWDATA(GRAF0491)
```
Under the ENTRY(SGP) setting, CA ACF2 for VM adds the input source GRAF0491 to the source group RM433.
OLDDATA removes an item from the entry record:
```
CHANGE RM433 OLDDATA(GRAF0491)
```
CA ACF2 for VM removes the source GRAF0491 from the input source group RM433.
Specify NEWDATA and VERDATA with the LIKE parameter and a mask. The NEWDATA item is added to all entry records containing the VERDATA item whose group name matches the mask supplied in the LIKE parameter:
```
CHANGE LIKE(RM***) VERDATA(GRAF0491) NEWDATA(GRAF0492)
```
CA ACF2 for VM adds the input source GRAF0492 to each group whose name begins with RM and extends up to seven characters and that already contains the input source GRAF0491.
When you specify OLDDATA and VERDATA, and a match occurs, the entry is deleted.
NEWDATA and OLDDATA replaces data:
```
CHANGE RM433 OLDDATA(GRAF0492) NEWDATA(GRAF0490)
```
CA ACF2 for VM removes input source GRAF0492 and replaces it with GRAF0490 in the source group RM433.

For information on how to activate a changed entry record, see the Activating and Changing Entry Records section.

Displaying Entry Records

Use the LIST subcommand under the ENTRY setting to list a record name or all entries that match a record name mask.


      { *              }
List  { recordname     }
      { LIKE(recmask)  }

*: Specifies that you want to list the last record of this type processed since you established the ENTRY setting with a specific type code.
recordname: Specifies that you want to list the one‑ to eight‑character name of an individual entry record.
LIKE(recmask): Selects only entry records that match the mask you specified.

LIST RM433 TYP: SGP ENTRY RM433 3 DATA ITEMS GRAF0490 GRAF0491 GRAF0492

Deleting Entry Records

Use the DELETE subcommand under the ENTRY setting to remove a record name or all entries that match a record name mask. The syntax is:


       { *             }
DELete { recordname    }
       { LIKE(recmask) }

*: Specifies that you want to delete the last record of this type processed since you established the ENTRY setting with a specific type code.
recordname: Specifies that you want to delete the one‑to eight‑character name of an individual entry record.
LIKE(recmask): Selects only entry records that match the mask you specified.

Ending Entry Record Processing

When you have finished processing entry records, enter the following command:

END

This exits you from the ACF command setting.