CA WA CA 7 Edition Environment › Configuration for CA IAS and CA WA CA 7 Edition › CA WA CA 7 Edition File › DDNAME=CA7AGNT

DDNAME=CA7AGNT

The CA7AGNT VSAM file, sometimes known as the agent information file, contains information returned from the CA Workload Automation agents when a job has been executed. The information includes last status of job information and other data required to retrieve more job information from the CA WA Agent. The information retained in this file about the agent jobs is displayed through the AGFILE command. The AGFILE command can also retrieve data from the CA WA Agent, such as spool files.

This file grows based on the number of agent jobs submitted. You can clear the file using the /DELAGNT command. The /DELAGNT command removes records from the file older than the number of days specified in the command or in the default specification of the initialization file AGENTDAY parameter. Back up and reorganize the file periodically through the normal ICDAMS utility. Because the /DELAGNT command removes records from the file, execute the command before the reorganization takes place.

Note: For more information about the AGFILE and /DELAGNT commands, see the CA WA CA 7 Edition Command Reference Guide.

To allocate the CA7AGNT file and initialize it with a seed record, use the CA WA CA 7 Edition SYSGEN job CA07N010 (found in the JCLLIB), which references the file under ddname DDAGENT. The job pulls in the SYSIN member AGTALLOC (also found in the JCLLIB). Depending on the number of agent jobs to execute, adjust the space allocation. Each execution of the job requires one record, variable-length, with an average size of about 400 bytes. Also, consider the number of days to retain the information about the CA7AGNT file in the space allocation. This file is active when agent jobs are executed, because the file is updated for every job execution and for various commands performed for an agent job.

Back up this file on a periodic basis because the information is required to retrieve information about executed agent jobs. In addition to the backup, reorganize the file periodically. Free space is initially 30 percent (CI) and 30 percent (CA) because record keys are tied to the job name, and the job can be executed frequently. This percentage can be adjusted based on the installation needs. The JCL procedure members in the SYSGEN JCLLIB for backup and reload are CA7AGBK and CA7AGRL, respectively.