URIMPDEF Resource Table

A CICS definition that describes the universal resource identifier (URI) of requests from web clients or requests to a remote server.

The Primary key field for this resource class is NAME.

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.

ADDTOGRP
Add to resource group

PARM(' [ERRQUEUE] RESGROUP(value) .')

Note: When creating this resource you should consider specifying the HOST attribute in lower case as CICS will convert this attribute name to lower case at install time. If you have not used a lower case name, you may subsequently have difficulty finding your host.

External resource name
CICSDefinitionURIMap
Length
1392
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
EYUt3833
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. URIMPDEF FEEDBACK error codes
Value Code Description
1 URIMPDEF_INV_DATA Attribute data invalid
2 URIMPDEF_REC_NOT_FOUND Requested resource not found
4 URIMPDEF_REC_EXISTS Resource already exists
5 URIMPDEF_REC_CHANGED Resource definition already changed
6 URIMPDEF_INV_RESTYPE Invalid resource type
7 URIMPDEF_INV_VER Invalid resource version
11 URIMPDEF_NON_MP Maintenance point CMAS not available
12 URIMPDEF_INV_CONTEXT Context not found
13 URIMPDEF_INCONSISTENT_SET Inconsistent set condition
14 URIMPDEF_INV_RESGROUP Resource group not found
21 URIMPDEF_INV_ACTION Invalid action
22 URIMPDEF_INV_RECADDR Invalid record address
23 URIMPDEF_INV_RECLEN Invalid record length
24 URIMPDEF_DIFF_VERSION Different version
25 URIMPDEF_EARLY_NAMELIST_END Early name list end
26 URIMPDEF_INV_NAMELIST Invalid name list
27 URIMPDEF_INV_NAME Invalid name
28 URIMPDEF_INV_MINNAME Invalid minor name
29 URIMPDEF_NOTIFY Notify
30 URIMPDEF_PARTIAL_INSTALL Partial install
31 URIMPDEF_NOTHING_INSTALLED Nothing installed
32 URIMPDEF_NO_TARGETS No targets
33 URIMPDEF_NO_RELATED No related systems
34 URIMPDEF_INV_TSCOPE Invalid target scope
35 URIMPDEF_INV_RSCOPE Invalid related scope
36 URIMPDEF_INV_USAGE Invalid usage
37 URIMPDEF_INV_MODE Invalid mode
38 URIMPDEF_INV_STATECHK Invalid state check
39 URIMPDEF_INV_FORCEINS Invalid force install
40 URIMPDEF_INV_NOTIFY Invalid notify
41 URIMPDEF_INV_OVERTYPE Invalid over type
42 URIMPDEF_INV_OVRBLOCK Invalid override block
43 URIMPDEF_INV_ORSTRING Invalid override string
44 URIMPDEF_INV_STRNGTERM Invalid string term
45 URIMPDEF_INV_EMBEDTERM Invalid embedded terminator
46 URIMPDEF_INV_ATTRIBUTE Invalid attribute
47 URIMPDEF_INV_LITERAL Invalid literal
48 URIMPDEF_INV_ORSTGNA Invalid override string
49 URIMPDEF_SCOPE_REQUIRED Scope required
50 URIMPDEF_USAGE_CONFLICT Usage conflict
51 URIMPDEF_NODEFS_SELECTED No definitions selected
52 URIMPDEF_MORE_THAN_1_RELSYS More than one related system
53 URIMPDEF_MISSING_RELSYSID Missing related system identifier
54 URIMPDEF_SCOPE_CONFLICT Scope conflict
55 URIMPDEF_INV_CSDGROUP Invalid CSD group
56 URIMPDEF_REC_NOT_REMOVED Record not removed
57 URIMPDEF_INV_RESOURCE Invalid resource
58 URIMPDEF_INV_CICS_RESTYPE Invalid CICS restype
59 URIMPDEF_PARTIAL_ACTION Partial action
60 URIMPDEF_NOTHING_ACTIONED Nothing actioned
61 URIMPDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62 URIMPDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
63 URIMPDEF_CSD_ERROR CSD access error
64 URIMPDEF_INVALID_PATH Invalid PATH for USAGE(CLIENT).
Table 3. URIMPDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Attr ID
ANALYZER EYUDA CPSM 4 No LIKE Use an analyzer program to process HTTP request NO     26
ANALYZER Input/output valid values NO, YES
ATOMSERVICE CHAR CPSM 8 No AVG Atomservice that will process the request.     E640 E650 44
AUTHENTICATE EYUDA CPSM 4 Yes LIKE Authentication level N_A   E640 E650 45
AUTHENTICATE Input/output valid values N_A, NO, BASIC
CERTIFICATE CHAR CPSM 32 No DIFF SSL client certificate for outbound HTTPS request       33
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     E640 E650 39
CHANGEAGENT Input/output valid values DREPAPI
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     E640 E650 41
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time       1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     E640 E650 40
CHARACTERSET CHAR CPSM 40 No DIFF Character set of CICS response to the HTTP request       21
CIPHERS CHAR CPSM 56 No DIFF Cipher suite codes to be used for outbound SSL       34
CONVERTER CHAR CPSM 8 No DIFF Converter program to process request content       27
CREATETIME DATETIME CPSM 8 Yes MAX Time created       9
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group     E640 E650 46
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   5
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   38
DESCRIPTION CHAR CPSM 58 No DIFF Description       13
HFSFILE CHAR CPSM 255 No DIFF Qualified zFS file to form the static response       24
HOST CHAR CPSM 116 Yes DIFF Host component of URI to which the map applies       18
HOSTCODEPAGE CHAR CPSM 10 No DIFF Code page in which the static response is encoded       22
LOCATION CHAR CPSM 255 No DIFF URI to which to redirect the inbound HTTP request       35
MEDIATYPE CHAR CPSM 56 No DIFF Media type of CICS response to the HTTP request       20
 NAME-1  CHAR CPSM 8 Yes DIFF Name       7
PATH CHAR CPSM 255 Yes DIFF Path component of URI to which the map applies       19
PIPELINE CHAR CPSM 8 No DIFF Pipeline that will process the request       30
PORT CHAR CPSM 8 No DIFF Port number NO 1-65535 E640 E650 43
PORT Input/output valid values NO
PROGRAM CHAR CPSM 8 No DIFF Application program that will process the request       29
REDIRECTTYPE CVDAS CPSM 4 Yes LIKE Type of redirection NONE     37
REDIRECTTYPE Input/output valid values NONE, TEMPORARY, PERMANENT
SCHEME CVDAS CPSM 4 Yes LIKE Scheme component of URI to which the map applies HTTP     17
SCHEME Input/output valid values HTTP, HTTPS
SOCKETCLOSE CHAR CPSM 6 No DIFF Time out for pooled sockets (HHMMSS)     E640 E650 E660 47
STATUS CVDAS CPSM 4 Yes LIKE Enabled status ENABLED     15
STATUS Input/output valid values ENABLED, DISABLED
TCPIPSERVICE CHAR CPSM 8 No DIFF Inbound TCP/IP service relating to this URI map       25
TEMPLATENAME CHAR CPSM 48 No DIFF Document template to form the static response       23
TRANSACTION CHAR CPSM 4 No DIFF Alias transaction to run application for response       28
USAGE CVDAS CPSM 4 Yes LIKE URI map usage type SERVER     16
USAGE Input/output valid values SERVER, CLIENT, PIPELINE, ATOM, JVMSERVER
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       10
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       11
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       12
USERID CHAR CPSM 8 No DIFF The user ID to attach the alias transaction       32
WEBSERVICE CHAR CPSM 32 No DIFF Web service that will process the request       31