- Atifacility (intrapartition queues only)
- specifies the type of destination the queue represents.
- FILE
- The transient data queue is to be used as a file of data records that
are not associated with a particular terminal or system. ATI does not require
a terminal to be available.
- SYSTEM
- The transient data queue is to be associated with the specified system
identifier. The system must be defined to the local CICS® system using an RDO CONNECTION definition.
Specifying Atifacility=System initiates a distributed transaction processing
(DTP) session. For more information about DTP considerations in application
programming, see the CICS Application Programming Guide.
- TERMINAL
- The transient data queue is to be associated with the terminal. The
terminal must be defined to CICS. If you do not specify TERMINAL, it defaults
to the value of FACILITYID. If ATI is used, as specified in the TRANSID and
TRIGGERLEVEL attributes, the transaction that is initiated is associated with
the specified terminal, which must be available before the transaction can
be initiated.
- Blockformat (extrapartition queues only)
- specifies the block format of the data set. There is no default. If
you specify the record format (RECORDFORMAT attribute) as undefined (or allow
it to default), you cannot specify anything for the BLOCKFORMAT attribute.
- BLOCKED
- Blocked record format.
- UNBLOCKED
- Unblocked record format.
- NOTAPPLIC
- No block format is defined for this datat set.
- blank
- The block format will be derived from the associated data set.
- Blocksize (extrapartition queues only)
- specifies the length of the block, in bytes. The
block length should be in the range 0 through
32767. If you leave this field blank, CICSPlex® SM uses the default value for your
CICS environment, if there is one.
- Databuffers (extrapartition queues only)
- specifies the number of buffers to be provided, up to a maximum of 255. If you leave this field blank, CICSPlex SM uses the default value
for your CICS environment, if there is one.
- Dname
- specifies a 1-to 8-character value that may refer to a data set defined
in the startup JCL.
- Description
- (Optional.) Specifies a 1- to 30-character description of the resource.
- Disposition (extrapartition queues only)
- specifies the disposition of the data set.
- MOD
- CICS first assumes that the data set exists. For an existing sequential
data set, MOD causes the read/write mechanism to be positioned after the last
record in the data set. The read/write mechanism is positioned after the last
record each time the data set is opened for output.
- OLD
- The data set existed before this job step.
- SHR
- The data set existed before this job step and can be read by other concurrent
jobs.
- (extrapartition queues only)
- specifies the name of the QSAM data set that is to be used to store
records written to this extrapartition queue.
- Erroroption (extrapartition
queues only)
- specifies the action to be taken if an I/O error occurs. This can be
one of the following:
- IGNORE
- The block that caused the error is accepted.
- SKIP
- The block that caused the error is skipped.
- Facilityid (intrapartition queues only)
- specifies a 4-character field that contains either:
- The system identifier for an intrapartition queue that specifies ATIFACILITY(SYSTEM)
- The terminal identifier where ATIFACILITY(TERMINAL) is specified.
If you do not specify anything in the FACILITYID field, it defaults
to the name of the queue in each case.
If ATIFACILITY(FILE) is specified,
the FACILITYID field must be left blank.
- Indirectname (indirect queues only)
- specifies the name of a transient data queue. The queue can be intrapartition,
extrapartition, remote, or indirect.
- Opentime (extrapartition queues only)
- specifies the initial status of the data set. The initial status can
be one of the following:
- DEFERRED
- The data set remains closed until you indicate that you want to
open it by using the CEMT INQUIRE|SET TDQUEUE command.
- INITIAL
- The data set is to be opened at install time.
- Printcontrol (extrapartition
queues only)
- specifies the control characters to be used. There is no default.
- ASA
- ASA control characters.
- MACHINE
- Machine control characters.
- N/A
- The Printcontrol value does not apply to this definition and should
not be validated.
- blank
- The control characters will be derived from the associated data set.
- Recordformat (extrapartition queues
only)
- specifies the record format of the data set.
- FIXED
- Fixed records. If you specify RECORDFormat(Fixed), you must
also specify a block format.
- VARIABLE
- Variable records. If you specify RECORDFormat(Variable), you must also
specify a block format.
- UNDEFINED
- Record format not defined.
- blank
- The record format will be derived from the associated data set.
- Recordsize (extrapartition and remote
queues)
- specifies the record length in bytes, in the
range 0 through 32767. If you leave this field blank, CICSPlex SM
uses the default value for your CICS environment, if there is one.
- Recovstatus (intrapartition queues only)
- specifies the recoverability attributes of the queue in the event of
an abnormal termination of either CICS or the transaction that is processing
the queue. The recoverability attributes are:
- LOGICAL
- This queue is logically recoverable.
- NO
- This queue is not recoverable.
- PHYSICAL
- This queue is physically recoverable.
- Remotename (remote queues only)
- (Optional.) specifies, if the transient data
queue resides on a remote system, the 4-character name by which the queue
is known in the system or region on which the queue resides.
- Remotelength (remote queues only)
- (Optional.) specifies the length in bytes,
in the range 1 through 32767. The default value is 1.
If you leave this field blank, CICSPlex SM uses the default value for your CICS
environment, if there is one.
- Remote Sysid
-
(Optional.) specifies, if the transient
data queue resides on a remote system, the name of the connection that links
the target (local) system to the related (remote) system where the transient
data queue resides. If this attribute is not supplied, RemoteSystem is derived
directly from the CICS system id of the related system, and the connection
that links the target system to the related system must have the same name
as the CICS system id of the related system.
- RESGROUP
- (Optional.) Specify the name of an existing resource group to which
the definition is to be automatically added.
- Rewind (extrapartition queues only)
- specifies the disposition of a tape data set. The disposition can be
one of the following:
- LEAVE
- The current tape is positioned at the logical end of the data set.
- REREAD
- The current tape is positioned at the logical start of the data set.
- Sysoutclass (extrapartition queues only)
- Instead of allocating an extrapartition queue to a physical data set,
you can allocate it to a system output data set (referred to as SYSOUT).
Use the SYSOUTCLASS attribute to specify the class of the SYSOUT data set.
- A..Z|0..9
- A single alphabetic or numeric character that represents an output class
that has been set up on the MVS™ system on which the CICS job is to run.
- *
- This is the default class. SYSOUTCLASS defaults to an asterisk (*) if
you leave the DSNAME attribute blank and specify OUTPUT for the Typefile field.
- blank
- SYSOUTCLASS defaults to a blank character if you leave the DSNAME attribute
blank and specify INPUT or RDBACK for the Typefile attribute.
- Transid (intrapartition queues only)
- specifies the name of the transaction that is to be automatically initiated
when the trigger level is reached.
- Triggerlevel (intrapartition queues only)
- specifies the number of records to be accumulated before a task is automatically
initiated to process them. (This number is known as the trigger level.)
If you specify the TRANSID attribute, TRIGGERLEVEL defaults to 1. Specify
a trigger level of 0 if you want to disable ATI processing. If
you do not specify a transaction id, the trigger level is ignored. If you leave this field blank, CICSPlex SM uses the default value for your CICS
environment, if there is one.
- Type
- specifies the following types of transient data queue:
- EXTRA
- A queue that is outside the CICS region is allocated to CICS.
- INDIRECT
- An indirect queue is a queue that does not point to an actual data set,
but to another queue. An indirect queue can be extrapartition, intrapartition,
remote, or even another indirect queue.
- INTRA
- A queue for data that is to be stored temporarily.
- REMOTE
- A queue that is located on a remote system.
- Typefile
- specifies the type of data set the queue is to be associated with.
- INPUT
- An input data set.
- OUTPUT
- An output data set.
- RDBACK
- An input data set that is to be read backward.
Note:
This
is appropriate only for data sets that have been defined on magnetic tape.
- Userid (intrapartition queues only)
- specifies the userid you want CICS to use for security checking when
verifying the trigger-level transaction specified in the TRANSID field.
- Wait (intrapartition queues only)
- specifies whether an in-doubt unit of work (UOW) that has modified a
logically recoverable queue should wait for resynchronization with its coordinator
to determine whether to commit or back out the changes.
- NO
- The UOW is not to wait. Any changes made to recoverable resources are
to be backed out or committed, as specified by the ACTION attribute on the
TRANSACTION resource definition.
- YES
- The UOW is to wait, and any action required while waiting is determined
by the WAITACTION attribute.
- N/A
- The Wait field does not apply to this definition.
- Waitaction (intrapartition queues only)
- specifies the action CICS is to take for an in-doubt unit of work (UOW)
if the definition for this queue specifies WAIT(YES). The possible actions
are:
- QUEUE
- The UOW is in-doubt and waiting; any locks held by the UOW for this
queue remain active until the final state of the UOW is known. This means
that tasks are suspended rather than receiving the LOCKED response. When the
final state of the UOW is known, any changes that it has made are committed
or backed out. Until then, any further requests of the following types that
need one of the active locks must wait:
- READQ, if the in-doubt UOW had issued READQ or DELETEQ requests.
- WRITEQ, if the in-doubt UOW had issued WRITEQ or DELETEQ requests.
- DELETEQ, if the in-doubt UOW had issued READQ, WRITEQ or DELETEQ requests.
- REJECT
- The UOW is in-doubt and is waiting. Any lock held by the UOW for this
queue is retained until the final state of the UOW is known. When the final
state is known, any changes the UOW has made are committed or backed out.
Until then, any further request that needs one of the retained locks is rejected,
and a LOCKED response is returned. WAITACTION=REJECT causes LOCKED to be raised
in exactly the same circumstances as those in which QUEUE causes a transaction
to wait.
- N/A
- The Waitaction field does not apply to this definition and should not
be validated.