The SET command options

You can use the SET command to modify groups of server initialization parameters.

These system initialization parameter groups are:
  • The statistics parameters
  • The debug trace parameters
  • The lock wait parameters
  • The warning parameters
  • The automatic ALTER parameters.

The following SET keywords are used to modify the server's recovery status of an inactive CICS® region that had unresolved units of work when it last terminated:

RESTARTED=applid
Establish a temporary recoverable connection for the given APPLID. This resolves any units of work that were in commit or backout processing when the region last terminated, and indicates whether there are any remaining indoubt units of work.

This keyword can be abbreviated to RESTART or REST.

COMMITTED={applid|applid.uowid}
Establish a temporary recoverable connection for the specified APPLID and commit all indoubt units of work, or, if uowid is also specified, commit that specific unit of work.

This command should be used only when it is not possible to restart the original CICS region to resolve the work normally, because it can result in inconsistency between coupling facility data table resources and other CICS resources updated by the same unit of work.

This keyword can be abbreviated to COMMIT or COMM.

BACKEDOUT={applid|applid.uowid}
Establish a temporary recoverable connection for the specified APPLID and back out all indoubt units of work, or, if uowid is also specified, back out that specific unit of work.

This command should be used only when it is not possible to restart the original CICS region to resolve the work normally, because it can result in inconsistency between coupling facility data table resources and other CICS resources updated by the same unit of work.

This keyword can be abbreviated to BACKOUT or BACK.

Use the following SET parameters to modify options relating to a specific table:

TABLE=name
specifies the table to which the following table-related parameters in the same command are to be applied. This parameter is required before any table-related parameters.
MAXRECS=number
Modify the maximum number of records that can be stored in the table specified by the preceding TABLE parameter.

If the maximum number is set to a value less than the current number of records in the table, no new records can be stored until records have been deleted to reduce the current number to within the new maximum limit. For a recoverable table, this also means that records cannot be updated, because the recoverable update process adds a new record on the rewrite operation then deletes the original record when the transaction completes.

This keyword can also be specified as MAXNUMRECS.

AVAILABLE={YES|NO}
Specify whether the table named by the preceding TABLE parameter is available for new OPEN requests. If the table is made unavailable, a CICS region that subsequently issues an OPEN request for the table receives a response indicating that it is unavailable, but regions that currently have the table open are not affected. Even when a table is marked as unavailable, a server can implicitly open it on behalf of a CICS region to allow recoverable work to be resolved during restart processing.

This keyword can be abbreviated to AVAIL.

Examples of the SET command: The following example changes the statistics options:
SET STATSOPT=BOTH,EOD=21:00,STATSINT=06:00
The following example modifies the maximum number of records allowed in the specified table:
SET TABLE=PAYECFT1,MAXRECS=200000