TDQDEF Resource Table

A CICS® Definition that describes an intrapartition, extrapartition, indirect or remote transient data queue.

The First key field for this resource is NAME. Note that a TDQ name can be only 4 characters long. The remainder of the 8-character NAME field should be padded with blank spaces.

The Second key field for this resource is DEFVER.

The Third key field for this resource is CSDGROUP.

The following actions are supported:
ADDTOGRP
Add to resource group
The parameter data for the ADDTOGRP action is:
   PARM('RESGROUP(resgroup).')

     where:

     resgroup = The name of a RESGROUP definition.
CSDCOPY
Copy the CICS CSD resource definition in a CSD group into an different CSD group.
The parameter data for the CSDCOPY action is described in Managing CICS definitions in the CSD.
CSDINSTALL
Install the CICS CSD resource definition in a CSD group into an active system.
The parameter data for the CSDINSTALL action is described in Managing CICS definitions in the CSD.
INSTALL
Install a Transient Data Queue Definition.

The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

External resource name(CMCI)
CICSDefinitionTDQueue
Object type
CICS Definition
Length
408
Usage
API, Batch Utility, WUI, CICS Management Client Interface(CMCI)
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Copybook identifier
EYUt3811
Security Class
OPERATE.TDQUEUE
CICS Commands subject to CICS Security
INQUIRE TDQUEUE
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
CREATE   CSD No
    RESGROUP(value) No
GET   CICSGRP(value) No
    CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
REMOVE   CSD No
UPDATE   CSD No
PERFORM SET, PERFORM OBJECT ADDTOGRP RESGROUP(value) Yes
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
  CSDINSTALL None N/A
  INSTALL FORCEINS(YES, NO) No
    MODE(INTRA, EXTRA, IND) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    OVERRIDE No
    OVERTYPE(TARGET, RELATED, BOTH, NONE) No
    RELATED(value) No
    STATECHK(YES, NO) No
    TARGET(value) Yes
    USAGE(LOCAL, REMOTE) Yes
Table 2. TDQDEF FEEDBACK error codes
Value Code Description
1 TDQDEF_INV_DATA Attribute data invalid
2 TDQDEF_REC_NOT_FOUND Requested resource not found
4 TDQDEF_REC_EXISTS Resource already exists
5 TDQDEF_REC_CHANGED Resource definition already changed
6 TDQDEF_INV_RESTYPE Invalid resource type
7 TDQDEF_INV_VER Invalid resource version
11 TDQDEF_NON_MP Maintenance point CMAS not available
12 TDQDEF_INV_CONTEXT Context not found
13 TDQDEF_INCONSISTENT_SET Inconsistent set condition
14 TDQDEF_INV_RESGROUP Resource group not found
21 TDQDEF_INV_ACTION Invalid action
22 TDQDEF_INV_RECADDR Invalid record address
23 TDQDEF_INV_RECLEN Invalid record length
24 TDQDEF_DIFF_VERSION Different version
25 TDQDEF_EARLY_NAMELIST_END Early name list end
26 TDQDEF_INV_NAMELIST Invalid name list
27 TDQDEF_INV_NAME Invalid name
28 TDQDEF_INV_MINNAME Invalid minor name
29 TDQDEF_NOTIFY Notify
30 TDQDEF_PARTIAL_INSTALL Partial install
31 TDQDEF_NOTHING_INSTALLED Nothing installed
32 TDQDEF_NO_TARGETS No targets
33 TDQDEF_NO_RELATED No related systems
34 TDQDEF_INV_TSCOPE Invalid target scope
35 TDQDEF_INV_RSCOPE Invalid related scope
36 TDQDEF_INV_USAGE Invalid usage
37 TDQDEF_INV_MODE Invalid mode
38 TDQDEF_INV_STATECHK Invalid state check
39 TDQDEF_INV_FORCEINS Invalid force install
40 TDQDEF_INV_NOTIFY Invalid notify
41 TDQDEF_INV_OVERTYPE Invalid overtype
42 TDQDEF_INV_OVRBLOCK Invalid override block
43 TDQDEF_INV_ORSTRING Invalid override string
44 TDQDEF_INV_STRNGTERM Invalid string term
45 TDQDEF_INV_EMBEDTERM Invalid embedded terminator
46 TDQDEF_INV_ATTRIBUTE Invalid attribute
47 TDQDEF_INV_LITERAL Invalid literal
48 TDQDEF_INV_ORSTGNA Invalid override string
49 TDQDEF_SCOPE_REQUIRED Scope required
50 TDQDEF_USAGE_CONFLICT Usage conflict
51 TDQDEF_NODEFS_SELECTED No definitions selected
52 TDQDEF_MORE_THAN_1_RELSYS More than one related system
53 TDQDEF_MISSING_RELSYSID Missing related system identifier
54 TDQDEF_SCOPE_CONFLICT Scope conflict
55 TDQDEF_INV_CSDGROUP Invalid CSD group
56 TDQDEF_REC_NOT_REMOVED Record not removed
57 TDQDEF_INV_RESOURCE Invalid resource
58 TDQDEF_INV_CICS_RESTYPE Invalid CICS restype
59 TDQDEF_PARTIAL_ACTION Partial action
60 TDQDEF_NOTHING_ACTIONED Nothing actioned
61 TDQDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 TDQDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 TDQDEF_CSD_ERROR CSD access error
Table 3. TDQDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Offset GraphQL Field
 NAME-1  CHAR CPSM 8 Yes DIFF Name       25 name
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   24 version
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group       392 CSDGroup
ATIFACILITY EYUDA CPSM 4 Yes LIKE Destination type TERMINAL     64 atifacility
ATIFACILITY Input/output valid values
  • TERMINAL
  • FILE
  • SYSTEM
BLOCKFORMAT CVDAS CPSM 4 No LIKE Block option NOTAPPLIC     36 blockformat
BLOCKFORMAT Input/output valid values
  • BLOCKED
  • UNBLOCKED
  • NOTAPPLIC
BLOCKSIZE CHAR CPSM 8 No DIFF Block size 0 0-32767   84 blocksize
BUFNO CHAR CPSM 4 No DIFF Number of buffers 1 1-255 E510+ 284  
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent       8 changeAgent
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release       20 changeAgentRelease
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time       0 changeTime
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID       12 changeUserID
CREATETIME DATETIME CPSM 8 Yes MAX Time created       296 createTime
DATABUFFERS CHAR CPSM 4 No DIFF Number of buffers 1 1-255   100 databuffers
DDNAME CHAR CPSM 8 Yes DIFF DD name       125 ddname
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   388 desccodepage
DESCRIPTION CHAR CPSM 58 No DIFF Description       328 description
DEVFILENAME CHAR CPSM 40 Yes DIFF Device file name     EALL 205  
DEVICEINIT EYUDA CPSM 4 Yes LIKE Open at initalization INITIAL   E330+ 288  
DEVICEINIT Input/output valid values
  • INITIAL
  • DEFERRED
DEVICETYPE EYUDA CPSM 4 Yes LIKE Type of device DISK   E330+ 276  
DEVICETYPE Input/output valid values
  • DISK
  • TAPE
  • PRINTER
DISPOSITION EYUDA CPSM 4 Yes LIKE Disposition SHR     44 disposition
DISPOSITION Input/output valid values
  • SHR
  • OLD
  • MOD
DSNAME CHAR CPSM 44 No DIFF DS name       133 dsname
ERROROPTION EYUDA CPSM 4 Yes LIKE Error option IGNORE     48 erroroption
ERROROPTION Input/output valid values
  • IGNORE
  • SKIP
FACILITYID CHAR CPSM 4 No DIFF Facility identifier       177 facilityid
FILELABEL EYUDA CPSM 4 Yes LIKE Write a standard label NO   EALL 272  
FILELABEL Input/output valid values
  • YES
  • NO
INDIRECTNAME CHAR CPSM 4 No DIFF Indirect transient data queue (TDQ) name       193 indirectname
JOBUSERID CHAR CPSM 8 No DIFF Default job user ID for jobs to JES internal rdr     E710 400 jobuserid
OPENTIME EYUDA CPSM 4 Yes LIKE Data set open time INITIAL     52 opentime
OPENTIME Input/output valid values
  • INITIAL
  • DEFERRED
PRINTCONTROL EYUDA CPSM 4 No LIKE Printer control N_A     56 printcontrol
PRINTCONTROL Input/output valid values
  • ASA
  • MACHINE
  • N_A
PRINTERNUM CHAR CPSM 4 No DIFF Printer number 1403 1403-5203 E330+ 280  
RECORDFORMAT CVDAS CPSM 4 No LIKE Record format UNDEFINED     40 recordformat
RECORDFORMAT Input/output valid values
  • UNDEFINED
  • VARIABLE
  • FIXED
RECORDSIZE CHAR CPSM 8 No DIFF Record size 1 0-32767   92 recordsize
RECOVSTATUS EYUDA CPSM 4 Yes LIKE Recovery option NO     68 recovstatus
RECOVSTATUS Input/output valid values
  • NO
  • PHYSICAL
  • LOGICAL
REMOTELENGTH CHAR CPSM 8 No DIFF Remote length 1 0-32767   112 remotelength
REMOTENAME CHAR CPSM 4 No DIFF Remote transient data queue (TDQ) name       197 remotename
REMOTESYSTEM CHAR CPSM 4 No DIFF System identifier of remote destination       201 remotesystem
RESIDENT EYUDA CPSM 4 Yes LIKE Queue is resident or non-resident YES   E330+ 264  
RESIDENT Input/output valid values
  • YES
  • NO
REUSE EYUDA CPSM 4 Yes LIKE Reuse control intervals YES   E330+ 260  
REUSE Input/output valid values
  • YES
  • NO
REWIND EYUDA CPSM 4 Yes LIKE Tape disposition LEAVE     60 rewind
REWIND Input/output valid values
  • LEAVE
  • REREAD
  • NOTAPPLIC
RSL CHAR CPSM 8 No DIFF Resource security value PUBLIC 1-24 E330+ 249  
RSL Input/output valid values
  • PUBLIC
SYSOUTCLASS CHAR CPSM 1 No DIFF System output (SYSOUT) class       124 sysoutclass
TAPEMARK EYUDA CPSM 4 Yes LIKE Write a file tapemark NO   EALL 268  
TAPEMARK Input/output valid values
  • YES
  • NO
TDQTYPE EYUDA CPSM 4 Yes LIKE Transient data queue (TDQ) type EXTRA     120 TDQType
TDQTYPE Input/output valid values
  • EXTRA
  • INTRA
  • INDIRECT
  • REMOTE
TERMID CHAR CPSM 4 No DIFF Terminal name       245 termid
TRANSID CHAR CPSM 4 No DIFF Transaction started at trigger level       181 transid
TRIGGERLEVEL CHAR CPSM 8 No DIFF Trigger level 1 0-32767   104 triggerlevel
TYPEFILE CVDAS CPSM 4 Yes LIKE Data set type INPUT     80 typefile
TYPEFILE Input/output valid values
  • INPUT
  • OUTPUT
  • RDBACK
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       304 userdata1
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       312 userdata2
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       320 userdata3
USERID CHAR CPSM 8 No DIFF User ID on the triggered transaction       185 userid
WAIT EYUDA CPSM 4 Yes LIKE Wait for UOW resynchronization N_A     72 wait
WAIT Input/output valid values
  • YES
  • NO
  • N_A
WAITACTION EYUDA CPSM 4 Yes LIKE In-doubt UOW wait action N_A     76 waitaction
WAITACTION Input/output valid values
  • REJECT
  • QUEUE
  • N_A