CICS 常用命令列表

 

cicscp

说明：CICS 控制程序，可用于创建、删除、启动、停止DCE，SFS服务器，CICS Region和PPC gateway

eneral cicscp usage:

cicscp [-?|([<common_options>] [<command> <noun_phrase> <specific_options>])]

where common options are:

        -I         - ignore errors

        -l logfile - log progress messages to file

        -v         - produce more verbose output

 

Specific commands are:

 

version:

        version

create COBOL:

        create cobol

destroy COBOL:

        destroy cobol

create SNA:

        create sna -d <Control Point Name>

                   -w <Local Network Name>

                   -x <XID Node ID>

                   -y <Link Station Type>

                   [-q <Link Station Name>]

                   [-s <Link Station Address>]

                   [-b <Local Secondary Station Address>]

destroy SNA:

        destroy sna [-f]

start SNA:

        start sna [-f]

stop SNA:

        stop sna [-f]

create telnet server:

        create telnet_server <server> [-P <port>]

                                      [-c <client codeset>]

                                      [-e <emulation>]

                                      [-h <host list>]

                                      [-l <locale>]

                                      [-m <model>]

                                      [-n <netname>]

                                      [-r <region>]

                                      [-s <server codeset>]

                                      [-t <transaction>]

destroy telnet server:

        destroy telnet_server <server> [-f]

create SFS server:

        create sfs_server <server> [-m <model>]

                                   [attribute overrides for SSD stanza]

destroy SFS server:

        destroy sfs_server <server> [-f]

start SFS server:

        start sfs_server <server> [attribute overrides for SSD stanza]

stop SFS server:

        stop sfs_server <server> [-f]

status SFS server:

        status sfs_server <server>

        stop sfs_server all

create PPC gateway server:

        create ppcgwy_server <server> [-m <model>]

                                      [attribute overrides for GSD stanza]

destroy PPC gateway server:

        destroy ppcgwy_server <server> [-f]

start PPC gateway server:

        start ppcgwy_server <server> [attribute overrides for GSD stanza]

stop PPC gateway server:

        stop ppcgwy_server <server> [-f]

status PPC gateway server:

        status ppcgwy_server <server>

        status ppcgwy_server all

create SNA link:

        create sna_link [<Link Station Name>]

                        -y <Link Station Type>

                        [-s <Link Station Address>]

                        [-b <Local Secondary Station Address>]

destroy SNA link:

        destroy sna_link <Link Station Name> -y <Link Station Type>

create region (SFS):

        create region <region> [-g <group-id>]

                               [-i <infile>]

                               [-l <c|m|o|r>]

                               [-d]

create region (DB2):

        create region <region> [-g <group-id>]

                               [-i <infile>]

                               [-l <c|m|o|r>]

                               [-a <alias> -o <instance>

                                [-u <user[,passwd]>] [-n|-s]]

create region (ORACLE):

        create region <region> -o ORACLE

                               [-g <group-id>]

                               [-i <infile>]

                               [-l <c|m|o|r>]

                               [-u <user[/passwd]>] [-n|-s]

destroy region (SFS):

        destroy region <region> [-f] [-s]

destroy region (DB2):

        destroy region <region> [-f] [-s [-u <user[,passwd]>]]

destroy region (ORACLE):

        destroy region <region> [-f] [-s [-u <user[/passwd]>]]

start region:

        start region <region> [-d <distributed servers>]

                              [attribute overrides for RD stanza]

stop region:

        stop region <region> [(-c | -f)]

status region:

        status region <region>

        status region all

destroy all:

        destroy all [-f]

start all:

        start all

stop all:

        stop all

status all:

        status all

 

使用举例：

5.1版本以前：

创建DCE

cicscp –v create dce -R

删除DCE:

cicscp -v destroy dce

 

创建Region:

cicscp -v create region CICSRGN1

启动SFS 服务器：

cicscp -v start sfs_server /.:/cics/sfs/SFS_SERV

cicsadd

说明：添加CICS资源定义

Usage: cicsadd {-?|-c className [-r regionName] [-P|-B] [-f fileName] [-m modelId] resourceName [[attributeName=attributeValue]...]}

 

使用举例：

以下命令在CICSRGN1中增加一个通讯定义。

cicsadd -r CICSRGN1 -B -c cd CD01 ConnectionType=cics_tcp /

       RemoteTCPAddress="9.181.108.37" RemoteTCPPort=1436 /

       ListenerName="lsnr1"

cicsget

说明：察看CICS资源定义

Usage: cicsget {-?|-c className [-r regionName] [-f fileName] {-l|-s [resourceName]|[resourceName]}}

使用举例：

以下命令察看CICSRGN1中名为CICSTEST的程序定义

cicsget -c pd -r CICSRGN1 CICSTEST

cicsupdate

说明：更改CICS资源定义的某个属性

Usage: cicsupdate {-?|-c className [-r regionName] [-P|-R|-B] [-f fileName] [resourceName] [[attributeName=attributeValue]...]}

使用举例：

以下命令更改CICSRGN1 CPMI交易的属性Permanent为no，RSLCheck为none

cicsupdate -r CICSRGN1 -B -c td CPMI Permanent=no RSLCheck=none

cicsinstall

说明：把一组资源定义安装到CICS Region的运行库中。

Usage: cicsinstall {-?|[-v] [-r regionName] {-a | -g groupName [groupName...] }}

使用举例：

把GROUP1中的所有资源定义安装到CICSRGN1的运行库中：

cicsinstall -r CICSRGN1 -g GROUP1

cicsdelete

说明：删除CICS Region某个资源定义

Usage: cicsdelete {-?|-c className [-r regionName] [-P|-R|-B] [-f fileName] resourceName [resourceName...]}

使用举例：

删除CICSRGN1中名字为CICSTEST的PD定义：

       cicsdelete -c pd -r CICSRGN1 -B CICSTEST

删除CICSRGN中名字为ABCD的TD定义：

       cicsdelete -c td -r CICSRGN1 -B ABCD

cicsexport

说明：导出Region资源定义

Usage: cicsexport {-?| [-r regionName] [-o outFile] [-t temporaryWorkspace] [-l className...]}

使用举例：

以下命令导出Region CICSRGN1的定义到CICSRGN1.dmp文件：

cicsexport -r CICSRGN1 -o CICSRGN1.dmp

cicsimport

说明：导入Region的资源定义

Usage: cicsimport {-?| -r regionName [-g groupName] [-i inFile] [-l m|o] [-v] [-F] [-o] [-B]}

使用举例：

以下命令导入一个名为CICSRGN1的Region，-S参数表示不使用DCE服务器

cicsimport -r CICSRGN1-i CICSRGN1.dmp-S

 

cicsmigrate

说明：创建用于移植CICS资源定义的移植脚本

Usage: cicsmigrate {-?|[ -r regionName | -s | -c | -p | -m ] -g fileName -o logFileName}

使用举例：

以下命令为Region CICSRGN1创建移植脚本，输出文件为CICSRGN1.sh

cicsmigrate -g CICSRGN1.sh -o log1 -r CICSRGN1

在K Shell下运行CICSRGN1.sh脚本

ksh CICSRGN1.sh

cicslssrc

说明：在Open平台察看cics 子系统的状态

使用举例：

cicslssrc -a

cicsnotify

说明：释放异常停止的Region所持有的资源

使用举例：

cicsnotify cics. CICSRGN1

cicsdfmt

说明：用于格式化CICS Dump文件

使用举例：

cicsdfmt -r CICSRGN1 A147DUMP.0001>A147.txt

cicstfmt

说明：用于格式化CICS Trace文件

使用举例：

cd /var/cics_regions/ CICSRGN1/dumps/dir1

cicstfmt *trc

cicssfmt

说明：格式化统计信息文件

使用举例：

cd /var/cics_regions/ CICSRGN1/data

格式化统计信息报告

cicssfmt statsfile>stat.1

格式化详细统计信息报告

cicssfmt -i statsfile>stat.1

cicsterm

说明：启动CICS 3270仿真终端，用于连接CICS Region

使用举例：

/usr/lpp/cics/bin/cicsterm

cicstail

说明：

动态查看console文件和CSMT.out文件

使用举例：

       cicstail –r CICSRGN1

 

cicssdt

说明：

导入导出sfs卷中的文件

Usage: cicssdt [-s Server] [-i inputFileName] [-o outputFileName] [-e] [-r] [-c commandName ...]

使用举例：

cicssdt –s /.:/cics/sfs/SFS_SERV

 

sfsadmin

说明：

sfs管理工具

       sfsadmin help {<command word>...}

Example: sfsadmin help import file

Available commands:

sfsadmin acquire lvol -- Acquire a logical volume into the server.

sfsadmin add index -- Add a secondary index to a file.

sfsadmin add lvol -- Add a logical volume to the server.

sfsadmin copy file -- Copy a file.

sfsadmin create clusteredfile -- Create a btree clustered file.

sfsadmin create relativefile -- Create a relative file.

sfsadmin create sequentialfile -- Create an entry sequenced (sequential) file.

sfsadmin deactivate index -- Deactivate a secondary index.

sfsadmin delete index -- Delete a secondary index.

sfsadmin destroy file -- Destroy a file.

sfsadmin empty file -- Delete all the records in a file.

sfsadmin enable server -- Enable the server.

sfsadmin expand file -- Enlarge the primary storage area for a file.

sfsadmin expand index -- Enlarge the storage area for a secondary index.

sfsadmin export file -- Export a file to a specified device.

sfsadmin help -- Display help message for given command

sfsadmin import file -- Import a file from a specified device.

sfsadmin list files -- List all files at the server.

sfsadmin list lvols -- List all logical volumes of a server.

sfsadmin list ofds -- List all ofds at the server.

sfsadmin query export -- Query an export set on a specified device.

sfsadmin query file -- Obtain information about a file.

sfsadmin query filelock -- Obtain information about locks on a file.

sfsadmin query index -- Obtain information about a secondary index.

sfsadmin query lvol -- Obtain information about a logical volume.

sfsadmin query ofd -- Obtain information about an ofd.

sfsadmin query server -- Obtain information about a server.

sfsadmin query tranlock -- Obtain information about transaction locks.

sfsadmin rebuild index -- Rebuild a secondary index.

sfsadmin release lvol -- Release a logical volume from the server.

sfsadmin rename file -- Rename a file.

sfsadmin rename index -- Rename an index.

sfsadmin reorganize file -- Reorganize a file.

sfsadmin set recordlimit -- Set max number of records on a file.

sfsadmin terminate ofd -- Terminate an ofd.

使用举例：

sfsadmin –s /.:/cics/sfs/SFS_SERV list files

ppcadmin

说明：

ppcadmin管理工具

ppcadmin help

ppcadmin help {<command word>...}

Example: ppcadmin help create luentry

Available commands:

ppcadmin cancel resync -- Cancel the specified resynchronization

ppcadmin create luentry -- Create an executive LU entry

ppcadmin create remoteluentry -- Create a remote LU entry

ppcadmin delete luentry -- Delete an executive LU entry

ppcadmin delete remoteluentry -- Delete a remote LU entry

ppcadmin destroy conv -- Unbind the session carrying the specified Conversation

ppcadmin enable server -- Complete server initialization

ppcadmin export configuration -- Export the configuration from a running PPC Gateway server to a file

ppcadmin force xln -- Force an XLN for the specified LU-LU pair

ppcadmin help -- Display help message for given command

ppcadmin list convs -- List all active SNA Conversations

ppcadmin list luentries -- List all registered executive LU entries

ppcadmin list luws -- List all active LUWs

ppcadmin list remoteluentries -- List all registered remote LU entries

ppcadmin list resyncs -- List all pending resynchronizations

ppcadmin list transactions -- List all active transactions

ppcadmin list xlns -- List XLN status for all known LU-LU pairs

ppcadmin modify luentry -- Modify an executive LU entry

ppcadmin query conv -- Query an active SNA Conversation

ppcadmin query gtid -- Query an active global transaction

ppcadmin query luentry -- Query an executive LU entry

ppcadmin query luw -- Query an active LUW

ppcadmin query remoteluentry -- Query a remote LU entry

ppcadmin query resync -- Query the specified resynchronization

ppcadmin query stats -- Query the specified Conversation and show its statistics

ppcadmin query transaction -- Query an active transaction

ppcadmin query xln -- Query XLN status for the specified LU-LU pair

ppcadmin stop server -- Terminate the specified Gateway Server

使用举例：

ppcadmin –s /.:/cics/ppc/gateway/GWY list luws

 

 

以下命令在6.1版本以后出现：

cicserr

说明：查看cics的错误代码的解释

Usage: cicserr [message number | help]

message number

        It should be a complete message code(like ERZxxxxxx | ERZxxxx | Axxx | Uxxxx).

help

        It prints usage(this) message

使用举例：

cicserr A147

cicserr ERZ046091I

 

 

 

 

 

 

CICS 常用通讯错误解释

通讯错误的格式

CICS通讯错误通常在CSMT.out中报出，格式如下：

ERZ027030E/3011 Communications error primaryCode/secondaryCode on connection to system 'sysId' occurred during remote command command 

 

这条错误信息中，primaryCode是主错误码，其中15a是模块代号。secondaryCode是二级错误码。通过primaryCode和secondaryCode可以了解到出现错误的原因。以下为文档中通信错误的详细说明：

 

 

主错误码解释表（减去15a00000）

主错误码	主错误码解释	从错误码解释
0x00000001	COMDL_PRI_ERROR_RECEIVED Indicating that the remote system has performed a ComDL_SendError. 对方应用程序使用了EXEC CICS ISSUE ERROR。	08890000，同主错误码
0x00000002	COMDL_PRI_ALLOCATE_FAILURE The conversation allocation failed. 尝试分配会话失败。	15a00101 COMDL_SUB_ALLOC_BUSY indicates that an attempt was made to allocate a conversation and no session was available. 没有可用的会话 15a00102 COMDL_SUB_ALLOC_FAILURE indicates a general allocation failure which means that something is wrong in the way the communications have been setup or that the remote sytem is not available for some reason. 远程系统不可用，或者是通讯链路的某种故障导致会话分配失败。
0x00000003	COMDL_PRI_TIMED_OUT The operation on the conversation did not complete in an acceptable timeframe. 会话分配超时。	15a00109 COMDL_SUB_TIMED_OUT The communications operation did not complete in the acceptable time frame. The timeout value is configured in the AllocateTimeout attribute in the Communications Definitions (CD) entry.会话分配超时，在CD定义中的AllocateTimeout时间内会话分配没有成功。
0x00000004	COMDL_PRI_INVALID_PARAMETER A parameter passed to the ComDL function was invalid. This is a strong indication of a possible program error within CICS itself. 传递的参数非法，通常不会遇到，如果遇到，建议联系IBM技术支持中心。	15a0010d Synclevel Not Supported Locally 15a00103 Invalid Convid  15a00104 Invalid Mode/Partner LU alias 15a00105 Invalid Parameter 15a00110 Exchange log name failed
0x00000005	COMDL_PRI_STATE_ERROR The ComDL function is not allowed at this time. 当前会话的状态不允许这样的调用。	15a00108 State Error 会话状态错误，可能是会话分配已经超时，而应用仍然尝试在该会话上执行函数调用。 15a00111 Backout required 交易必须回滚
0x00000006	COMDL_PRI_PROTOCOL_SPECIFIC Protocol specific failures. 协议相关的错误	15a0010c Local SNA not initialized 15a00106 Communications Protocol Specific Error
0x00000007	COMDL_PRI_CONV_TERMINATED A major failing has occured on the conversation. The conversation has been abnormally terminated.会话出现错误，被异常中止	a0000100 EIBERRCD_CONN_FAIL Connection failed. 连接失败。如果使用LINK, Response Code是Terminal Error。原因：在主调方达到TD Timeout后，远端region交易仍然在执行中，没有返回。 10086021 Transaction Unknown on Remote System. 会话的另一端系统中没有找到相应的TP定义(SNA错误)。 10086031 PIP Data Not Supported by the Remote System 10086032 PIP Data Incorrectly Specified  10086034 Conversation Type Mismatch 10086041 Sync Not Supported by Remote Program or Syste 80f6051 Security Violation  安全性检查失败。 84b6031 EIBERRCD_TPN_NOT_AVAIL  Remote Transaction Temporarily Not Available如果使用LINK, Response Code是Terminal Error. 原因 例如对方交易设置了TD的TClass，且该类交易ClassMaxTasks和ClassMaxTaskLim到达上限，直接被远端region拒绝，主调方报出该错误。 84c0000 Remote Transaction Not Available 8640000 Conversation Abnormal Termination (LINK主调方)如果伴随XPRecv Timeout，说明调用后台Region的程序执行时间过长，导致超时，这时后台Region应有A147/Exit 199等信息，应当分析后台交易执行时间长的原因。 8640001 EIBERRCD_ABEND_SVC Conversation Abnormal Termination  8640002 EIBERRCD_ABEND_TIMER Conversation Abnormal Termination
0x00000008	COMDL_PRI_DEALLOCATE_NORMAL The conversation has been terminated normally. 会话被正常中止。	15a00107 Conversation Terminated Normally
0x00000009	COMDL_PRI_BACKED_OUT The remote system has backed out the work it has done since the previous syncpoint. This indicates the transaction has been aborted and the conversation terminated. 远程系统对上次同步点后的事务进行回滚，表示交易中途失败，会话中止	8240000 Backed Out 事务回滚。
0x0000000A	COMDL_PRI_UNSUPPORTED The communications function called is not supported by the communications protocol. 调用的函数协议不支持。

X'080F6051'	The partner transaction failed security check.
X'08240000'	The partner transaction or system has issued SYNCPOINT ROLLBACK.
X'084B6031'	The partner system is temporarily unable to start the partner transaction.
X'084C0000'	The partner system cannot start the partner transaction.
X'08640000'	The Partner transaction has sent ISSUE ABEND.
X'08640001'	The Partner system has sent ISSUE ABEND.
X'08890000'	An ISSUE ERROR command has been received.
X'10086021'	The partner transaction's name is not recognized by the partner system.
X'10086031'	PIP data was specified but the remote process does not support it.
X'10086032'	The PIP data sent with the CONNECT PROCESS was incorrectly specified.
X'10086034'	The partner system does not support mapped conversations.
X'10086041'	The partner transaction does not support the synchronization level requested on the CONNECT PROCESS.

 

 

15a00007/a0000100

解释

Connection failed

如果使用LINK, Response Code是Terminal Error

原因：

在主调方达到TD Timeout后，远端region交易仍然在执行中，没有返回

 

15a00007/84b6031

解释

Transaction Not Available

如果使用LINK, Response Code是Terminal Error

原因

例如对方交易设置了TD的TClass，且改类交易ClassMaxTasks和ClassMaxTaskLim到达上限，直接被远端region拒绝，主调方报出该错误。

 

15a00007/8640000

解释

这个错误码不一定都对应A27K

Remote Tansaction Abend

如果本地使用LINK，本地交易Abend

原因

远端交易Abend

 

#define COMDL_SUB_ALLOC_PIP_ILLEGAL      EIBERRCD_PIP_ILLEGAL

#define COMDL_SUB_ALLOC_PIP_MALFORMED    EIBERRCD_PIP_INVALID

#define COMDL_SUB_CONN_FAILURE           EIBERRCD_CONN_FAIL

#define COMDL_SUB_CONV_TYPE_MISMATCH     EIBERRCD_MISMATCH

#define COMDL_SUB_DEALLOC_ABEND          EIBERRCD_ABEND

#define COMDL_SUB_DEALLOC_ABEND_SVC      EIBERRCD_ABEND_SVC

#define COMDL_SUB_DEALLOC_ABEND_TIMER    EIBERRCD_ABEND_TIMER

#define COMDL_SUB_SECURITY_INVALID       EIBERRCD_SECURITY_INVALID

#define COMDL_SUB_SYNC_NOT_SUPPORTED     EIBERRCD_SYNC_NOT_SUPPORTED

#define COMDL_SUB_TPN_NOT_AVAIL          EIBERRCD_TPN_FAIL

#define COMDL_SUB_TPN_NOT_AVAIL_RETRY    EIBERRCD_TPN_NOT_AVAIL

#define COMDL_SUB_TPN_UNKNOWN            EIBERRCD_UNKNOWN_TPN

 

/* Values which can be held by EIBERRCD */

 

#define EIBERRCD_SYNC                   (0x08240000)

#define EIBERRCD_ABEND                  (0x08640000)

#define EIBERRCD_ABEND_SVC              (0x08640001)

#define EIBERRCD_ABEND_TIMER            (0x08640002)

#define EIBERRCD_ERROR                  (0x08890000)

#define EIBERRCD_MISMATCH               (0x10086034)

#define EIBERRCD_PIP_ILLEGAL            (0x10086031)

#define EIBERRCD_PIP_INVALID            (0x10086032)

#define EIBERRCD_SECURITY_INVALID       (0x080f6051)

#define EIBERRCD_SYNC_NOT_SUPPORTED     (0x10086041)

#define EIBERRCD_UNKNOWN_TPN            (0x10086021)

#define EIBERRCD_CONN_FAIL              (0xA0000100)

#define EIBERRCD_CONN_FAIL_RETRY        (0xA0000100)

#define EIBERRCD_TPN_NOT_AVAIL          (0x084b6031)

#define EIBERRCD_TPN_FAIL               (0x084c0000)

 

EIBERRCD

This EIB field when EIBERR is set, contains the error code that has been received. The following values can be returned in the first two bytes of EIBERRCD:

·   X'0824' SYNCPOINT ROLLBACK was requested.

·   X'0864' ISSUE ABEND was received.

·   X'0889' ISSUE ERROR was received.

·   X'A000' The conversation was lost.