SET PROCESSTYPE
Change the attributes of a CICS® business transaction services (CBTS) process-type.
Description
SET PROCESSTYPE allows you to change the current state of audit logging and the enablement status of PROCESSTYPE definitions installed on this CICS region.
Note: Process-types are defined
in the process-type table (PTT). CICS uses
the entries in this table to maintain its records of processes (and
their constituent activities) on external data sets. If you are using
CBTS in a single CICS region,
you can use the SET PROCESSTYPE command to modify your process-types.
However, if you are using CBTS in a sysplex, it is strongly recommended
that you use CPSM to make such changes. This is because it is essential
to keep resource definitions in step with each other, across the sysplex.
Options
- AUDITLEVEL(cvda)
- specifies
the level of audit logging to be applied to processes of this type.
Note: If the AUDITLOG attribute of the installed PROCESSTYPE definition is not set to the name of a CICS journal, an error is returned if you try to specify any value other than OFF.The CVDA values are:
- ACTIVITY
- Activity-level auditing. Audit records are written from:
- The process audit points
- The activity primary audit points.
- FULL
- Full auditing. Audit records are written from:
- The process audit points
- The activity primary and secondary audit points.
- OFF
- No audit trail records are written.
- PROCESS
- Process-level auditing. Audit records are written from the process audit points only.
For details of the records that are written from the process, activity primary, and activity secondary audit points, see Specifying the level of audit logging.
- PROCESSTYPE(value)
- specifies the 8-character name of a process-type defined in the process-type table (PTT), whose attributes are to be changed.
- STATUS(cvda)
- specifies
whether new processes of this type can be created. The CVDA values
are:
- DISABLED
- The installed definition of the process-type is disabled. New processes of this type cannot be defined.
- ENABLED
- The installed definition of the process-type is enabled. New processes of this type can be defined.
Conditions
- INVREQ
- RESP2 values:
- 2
- The process-type is not disabled, and therefore cannot be enabled.
- 3
- You have specified an invalid CVDA value on the AUDITLEVEL option.
- 5
- You have specified an invalid CVDA value on the STATUS option.
- 6
- You have specified a value of FULL, PROCESS, or ACTIVITY on the AUDITLEVEL option, but the AUDITLOG attribute of the PROCESSTYPE definition does not specify an audit log.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- PROCESSERR
- RESP2 values:
- 1
- The process-type named in the PROCESSTYPE option is not defined in the process-type table (PTT).