You can set or change the parameters that trigger the archival process after you set up the OPSLOG archive system from the Parameters screen (4.1.1). Restart the ARCH subtask for these changes to take effect.
Consider the following information when you set parameters:
Important! When the number of messages specified by the ARCHIVETRIG parameter is set too close to the maximum capacity of the OPSLOG, there is a risk that not all your messages will be correctly archived.
T = OPSPRM_Set("ARCHIVETRIG","n")
/F OPSS,RESTART(ARCH)
Definitions
Specifies the number of messages that accumulate before the archive process starts.
Limits: The number of messages must be in the range 1-4925000.
Example: Trigger Archival After 10,000 Messages
The following example triggers the archive step after 10,000 messages:
T = OPSPRM_Set("ARCHIVETRIG","10000")
T = OPSPRM_Set("ARCHIVETRIG","hh:mm")
/F OPSS,RESTART(ARCH)
Definitions
Specifies the time of day at which archival begins.
Limits: 00:00-23:59
Example: Trigger Archival at 7:30pm
The following example triggers the archive step at 7:30pm every day:
T = OPSPRM_Set("ARCHIVETRIG","19:30")
T = OPSPRM_Set("ARCHIVETRIG","+hh:mm")
/F OPSS,RESTART(ARCH)
Specifies the interval of time in hours and minutes.
Limits: The minimum interval is +00:10; the maximum interval is +99:59.
Example: Trigger Archival After 2 Hours, 45 Minutes
The following example triggers the archive process at intervals of 2 hours, 45 minutes:
T = OPSPRM_Set("ARCHIVETRIG","+02:45")
To use the OPSLOG archive system, set up the ARCH subtask in your CA OPS/MVS procedures.
Note: It is possible to modify the archive parameters at a later date.
Follow these steps:
T = OPSPRM_Set("INITARCH","YES") T = OPSPRM_Set ("ARCHIVETRIG", "parameter") T = OPSPRM_Set ("ARCHIVEHLQ", "parameter")
T = OPSPRM_Set("ARCHIVEUNIT","parameter") T = OPSPRM_Set("ARCHIVESTORCLAS","parameter") T = OPSPRM_Set ("ARCHIVEVOLSER","parameter") T = OPSPRM_Set ("ARCHIVELIMIT","parameter")
Note: Look for the following subtask start message in the OPSLOG or syslog to verify that the ARCH subtask is running correctly:
OPx5002I OPSLOG subtask is active
After the ARCH subtask is set up it performs the following actions:
Example
The following examples show the archives that CA OPS/MVS creates if ARCHIVEHLQ is specified as USER.OPSS.NEWARCH:
USER.OPSS.NEWARCH USER.OPSS.NEWARCH.G0001V00 USER.OPSS.NEWARCH.G0002V00 USER.OPSS.NEWARCH.G0003V00 USER.OPSS.NEWARCH.MODEL
Note: For more information about the modification of archive parameters, see Set the Archive Parameters.
The ARCH subtask issues the following OPSLOG messages:
OPx5002I OPSLOG subtask is active OPx8330I OPSLOG archive creation request processing completed OPx8320O OPSLOG archive creation completed, MAXRC=O
Note: If a MAXRC <> 0 error message appears in the OPSLOG, see OPSLOG API Return Codes.
If you enter an invalid trigger parameter, the ARCH subtask issues the following message:
OPx8336E ARCHIVETRIG parameter is invalid: "value"
The OPSLOG API issues the following return codes:
No error occurred in processing
The OPS/MVS subsys was not found
Abend occurred during API processing
No parameters were passed to the API
A required parameter is missing
The control block is invalid
The control block is missing
Requested function unknown
Requested function unknown
Requested func/SFNC not yet supported
MVS authorization required
Authorization check failed
OPSLOG to process has invalid format
Global filter FREEMAIN failed
Conflicting parameters specified
Window search routine failed
At end of OPSLOG window
The request is out of sequence
Unable to allocate a DSN OPSLOG
Unable to initialize a DSN OPSLOG
Unable to unallocate a DSN OPSLOG
Unable to terminate a DSN OPSLOG
Out of room to add more filter code
Out of room to add more filter data
Invalid field name in filter/search
Numeric value length error
TOD of binary value length error
Char or hex value length error
Invalid operator - filter/search
Operator not supported, filter/search
Unknown operator - filter/search
Invalid connector - filter
Global filter GETMAIN failed
Archive dataset not allocated
Unable to open archive
Access parameter invalid
LRECL invalid
Unable to read archive
Unable to write to archive
Unable to close archive
Buffer length invalid on add request
Add to OPSLOG failed
Item being added is not an OPMO
Add is not allowed to this OPSLOG
ARCH IDENT first record not header
RQSD func not allowed for this OPSLOG
Supplied buffer too small for function
Supplied message number too high
Supplied message number too low
ARMO version is invalid
Archive record is not an ARMO
Retrieve from OPSLOG failed
ARCHIVE DD(OPSARCH) not preallocated
Window range has high lower than low
Window range is past end of log
Window range is before start of log
Window hi value past end - hiest set
Window low value bfor strt, lowest st
Window high near match - closest set
Window low near match - closest set
Window high & low near - closest set
Window is larger than log - set
OPSLOG is not a SUBSYS OPSLOG
No current position in the OPSLOG
Archive DSN not spec'd and no parm
Invalid subsystem name
Log name specified is not defined
Log name specified is not active
Copyright © 2014 CA Technologies.
All rights reserved.
|
|