IPCONDEF Resource Table

A CICS® Definition that describes an IPIC connection between CICS and a remote system.

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

The Secondary key field for this resource class is DEFVER.

The Tertiary key field for this resource class is CSDGROUP.

The following actions are supported:
INSTALL
Install a Connection Definition.

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

External resource name
CICSDefinitionIPICConnection
Length
448
Usage
API or Batch Utility or WUI or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICS Definition
Copybook identifier
EYUt3836
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
CREATE   CSD No
    RESGROUP(value) No
UPDATE   CSD No
REMOVE   CSD No
PERFORM SET INSTALL FORCEINS(YES, NO) No
    MODE(value) 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) Yes
  ADDTOGRP RESGROUP(value) Yes
  CSDINSTALL None N/A
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
Table 2. IPCONDEF FEEDBACK error codes
Value Code Description
1 IPCONDEF_INV_DATA Attribute data invalid
2 IPCONDEF_REC_NOT_FOUND Requested resource not found
4 IPCONDEF_REC_EXISTS Resource already exists
5 IPCONDEF_REC_CHANGED Resource definition already changed
6 IPCONDEF_INV_RESTYPE Invalid resource type
7 IPCONDEF_INV_VER Invalid resource version
11 IPCONDEF_NON_MP Maintenance point CMAS not available
12 IPCONDEF_INV_CONTEXT Context not found
13 IPCONDEF_INCONSISTENT_SET Inconsistent set condition
14 IPCONDEF_INV_RESGROUP Resource group not found
21 IPCONDEF_INV_ACTION Invalid action
22 IPCONDEF_INV_RECADDR Invalid record address
23 IPCONDEF_INV_RECLEN Invalid record length
24 IPCONDEF_DIFF_VERSION Different version
25 IPCONDEF_EARLY_NAMELIST_END Early name list end
26 IPCONDEF_INV_NAMELIST Invalid name list
27 IPCONDEF_INV_NAME Invalid name
28 IPCONDEF_INV_MINNAME Invalid minor name
29 IPCONDEF_NOTIFY Notify
30 IPCONDEF_PARTIAL_INSTALL Partial install
31 IPCONDEF_NOTHING_INSTALLED Nothing installed
32 IPCONDEF_NO_TARGETS No targets
33 IPCONDEF_NO_RELATED No related systems
34 IPCONDEF_INV_TSCOPE Invalid target scope
35 IPCONDEF_INV_RSCOPE Invalid related scope
36 IPCONDEF_INV_USAGE Invalid usage
37 IPCONDEF_INV_MODE Invalid mode
38 IPCONDEF_INV_STATECHK Invalid state check
39 IPCONDEF_INV_FORCEINS Invalid force install
40 IPCONDEF_INV_NOTIFY Invalid notify
41 IPCONDEF_INV_OVERTYPE Invalid over type
42 IPCONDEF_INV_OVRBLOCK Invalid override block
43 IPCONDEF_INV_ORSTRING Invalid override string
44 IPCONDEF_INV_STRNGTERM Invalid string term
45 IPCONDEF_INV_EMBEDTERM Invalid embedded terminator
46 IPCONDEF_INV_ATTRIBUTE Invalid attribute
47 IPCONDEF_INV_LITERAL Invalid literal
48 IPCONDEF_INV_ORSTGNA Invalid override string
49 IPCONDEF_SCOPE_REQUIRED Scope required
50 IPCONDEF_USAGE_CONFLICT Usage conflict
51 IPCONDEF_NODEFS_SELECTED No definitions selected
52 IPCONDEF_MORE_THAN_1_RELSYS More than one related system
53 IPCONDEF_MISSING_RELSYSID Missing related system identifier
54 IPCONDEF_SCOPE_CONFLICT Scope conflict
55 IPCONDEF_INV_CSDGROUP Invalid CSD group
56 IPCONDEF_REC_NOT_REMOVED Record not removed
57 IPCONDEF_INV_RESOURCE Invalid resource
58 IPCONDEF_INV_CICS_RESTYPE Invalid CICS restype
59 IPCONDEF_PARTIAL_ACTION Partial action
60 IPCONDEF_NOTHING_ACTIONED Nothing actioned
61 IPCONDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 IPCONDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 IPCONDEF_CSD_ERROR CSD access error
Table 3. IPCONDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Attr ID
APPLID CHAR CPSM 8 Yes DIFF Remote application ID       16
AUTOCONNECT EYUDA CPSM 4 Yes LIKE Autoconnect sessions for IPIC connections NO     8
AUTOCONNECT Input/output valid values NO, YES
CERTIFICATE CHAR CPSM 32 No DIFF Certificate       28
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     E640 E650 33
CHANGEAGENT Input/output valid values DREPAPI
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     E640 E650 35
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time       1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     E640 E650 34
CIPHERS CHAR CPSM 56 No LIKE SSL cipher suite codes       29
CREATETIME DATETIME CPSM 8 Yes MAX Time created       19
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group     E640 E650 38
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   5
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   24
DESCRIPTION CHAR CPSM 58 No DIFF Description       23
HA EYUDA CPSM 4 Yes LIKE High availability NO   E640 E650 E660 E670 E680 40
HA Input/output valid values NO, YES
HOST CHAR CPSM 116 Yes DIFF Remote host name       25
IDPROP CVDAS CPSM 4 Yes LIKE Identity propagation NOTALLOWED   E640 E650 37
IDPROP Input/output valid values NOTALLOWED, OPTIONAL, REQUIRED
INSERVICE EYUDA CPSM 4 Yes LIKE Connection status YES     9
INSERVICE Input/output valid values NO, YES
LINKAUTH CVDAS CPSM 4 No LIKE Link security SECUSER     32
LINKAUTH Input/output valid values SECUSER, CERTUSER
MAXQTIME CHAR CPSM 8 No DIFF Maximum queue time NO 0-9999   18
MAXQTIME Input/output valid values NO
MIRRORLIFE CVDAS INQ 4 No DIFF Minimum mirror lifetime REQUEST   E640 E650 E660 39
MIRRORLIFE Input/output valid values REQUEST, TASK, UOW
 NAME-1  CHAR CPSM 8 Yes DIFF Name       7
NETWORKID CHAR CPSM 8 No DIFF Remote network ID       15
PORT CHAR CPSM 5 Yes DIFF Port number NO 1-65535   13
PORT Input/output valid values NO
QUEUELIMIT CHAR CPSM 8 No DIFF Queue limit NO 0-9999   17
QUEUELIMIT Input/output valid values NO
RECEIVECOUNT CHAR CPSM 3 Yes DIFF Receive count   1-999   26
SECURITYNAME CHAR CPSM 8 No LIKE Security name of the remote system       30
SENDCOUNT CHAR CPSM 3 Yes DIFF Send count   0-999   27
SSL EYUDA CPSM 4 Yes LIKE Secure sockets layer (SSL) type NO     11
SSL Input/output valid values YES, NO
TCPIPSERVICE CHAR CPSM 8 Yes DIFF TCP/IP service       14
USERAUTH CVDAS CPSM 4 Yes LIKE Attach-time user security level LOCAL     12
USERAUTH Input/output valid values DEFAULTUSER, LOCAL, VERIFY, IDENTIFY
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       20
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       21
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       22
XLNACTION EYUDA CPSM 4 Yes LIKE Exchange log names (XLN) action KEEP     10
XLNACTION Input/output valid values KEEP, FORCE


IPCONDEFtab.html | Timestamp icon Last updated: Sunday, 4 June 2017