Options
FIELD(
data-area
)
specifies the field to be edited.
LENGTH(
data-value
)
specifies the field length in bytes.
Examples
EXEC CICS BIF DEEDIT
FIELD(CONTG)
LENGTH(9)
This removes all characters other than digits from CONTG, a 9-byte field, and returns the edited result in that field to the application program. Two examples of the contents of CONTG before and after execution of the command are:
Note that a decimal point is an EBCDIC special character and as such is removed.
CANCEL
Cancel an interval control request.
CANCEL
REQID (
name
)
TRANSID (
name
) SYSID (
name
)
Conditions:
INVREQ, ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR
Description
CANCEL cancels a previously issued DELAY, POST, or START command. If you include the SYSID option, the command is shipped to a remote system. If you omit
SYSID, the TRANSID option, if present, determines where the command is to be executed. The effect of the cancelation varies depending on the type of command being canceled, as follows: v
A DELAY command can be canceled only before it has expired, and only by a task other than the task that issued the DELAY command (which is suspended for the duration of the request). The REQID used by the suspended task must be specified. The effect of the cancelation is the same as an early expiration of the original DELAY. That is, the suspended task becomes dispatchable as though the original expiration time has been reached. v
When a POST command issued by the same task is to be canceled, no REQID need be specified. Cancelation can be requested either before or after expiration of the original request. The effect of the cancelation is as if the original request had never been made. v
When a POST command issued by another task is to be canceled, the REQID of that command must be specified. The effect of the cancelation is the same as an
Chapter 32. Application programming commands - reference
333
early expiration of the original POST request. That is, the timer event control area for the other task is posted as though the original expiration time had been reached. v
When a START command is to be canceled, the REQID of the original command must be specified. The effect of the cancelation is as if the original command had never been made. The cancelation is effective only before the original command has expired.
See Chapter 18, “Interval control,” on page 193 for more information.
Options
REQID(
name
)
specifies a name that uniquely identifies the command to be canceled. The name can be up to 8 characters long. This name is used as a temporary storage identifier. The temporary storage queue thus identified must be defined as a local queue on the CICS system where the CANCEL command is processed.
This option cannot be used to cancel a POST command issued by the same task (for which the REQID option is ignored if it is specified).
SYSID(
name
)
specifies the name of the system to which the request is directed. The name can be up to 4 characters long.
TRANSID(
name
)
specifies the symbolic identifier that determines where the CANCEL command is to be executed. The name can be up to 4 characters long and must have been defined in the program control table (PCT) unless the SYSID option specifies a remote system.
If a nonlocal SYSID is specified, the transaction is assumed to be on a remote system irrespective of whether the name is defined in the local PCT. Otherwise, the PCT entry is used to determine whether the transaction is on a local or a remote system.
Exception Conditions
INVREQ
occurs if the CANCEL command is not valid for processing by CICS.
Default action: Terminate the task abnormally.
ISCINVREQ
occurs if the remote system indicates a failure that does not correspond to a known condition.
Default action: Terminate the task abnormally.
NOTAUTH
occurs if the user requesting the CANCEL command is not authorized to the
CICS/400 temporary storage files for the control region in which the command is being run.
Default action: Terminate the task abnormally.
NOTFND
occurs if the request identifier specified fails to match an unexpired interval control command.
Default action: Terminate the task abnormally.
334
CICS for iSeries Application Programming Guide V5
