Note:
Table 15‑1 CICS Command (COBOL Support)
•
•
•
•
• 0: N/A
• 2: The supplied password is wrong.
• 3: A new password is required.
• 8: The user ID is not known to the external security manager.
• 13: There is an unknown return code in ESMRESP from the external security manager.
• 18: The CICS external security manager interface is not initialized.
• 19: The user ID is revoked.
• 29: The external security manager is not responding.
• ENTER TRACENUM was written as ENTER TRACEID in Mainframe CICS v3 or earlier. In each section, if INITPARM parameters are specified more than one time, only the last definition will take effect.
• DELETE RBA can only be used in KSDS dataset.
• WRITE RBA can only be used in ESDS dataset. Not supports for cancelling the remote requests issued by DELAY command. If not specified, START LENGTH will be automatically set. Its default value is in "LENGTH OF data-area" format; "data-area" is the one specified in FROM. This option cannot be used with TERMID. The specified REQID must be unique in START asynchronous CICS delayed transactions when /Q, or ARTSRM_ORA or ARTSRM_UDB implementation is used. The Oracle Tuxedo server, TMUSREVT, must be configured in the UBBCONFIG file to support this command. TERMID option cannot be used together with the RTRANSID/RTERMID/QUEUE option for the START TRANSID command. Specifies a value in the range 1 through 99, the number that is to be taken as the journal identifier. When specifying JFILEID as nn, the journal will be written to journal file DFHJnn. Only support for local node if there is no /*XEQ NODE line defined in JCL file for the automatic submission to JES. Supports only INTRDR Only VTAM is returned.
• Returns the value configured in either KIX_CICS_RELEASE environment variable or CICS_RELEASE in system configuration file systems.desc.If both of them are configured, the value in systems.desc is returned; If neither of them is configured, value '0660' (corresponding to CICS 4.1) is returned. Only NOTAPPLIC is returned.
– ACCESSMETHOD: VTAM
– CREATESESS: NOCREATE
– REMOTESYSTEM: Blank
–
– TRACING: STANTRACE
• CONNSTATUS equals to ACQSTATUS. Only VSAM is returned. The default value of DSNAME is the VSAM file name; once specified by SET FILE DSNAME, INQUIRE FILE DSNAME will return the specified value. Only NOEMPTYREQ is returned. Only 0 is returned. Only 0 is returned. Only NOTTABLE is returned. Recognized. Only RUNNING is returned. Recognized. Only NULL is returned. ART for CICS implements the same semantics for SET PROGRAM COPY (NEWCOPY) and SET PROGRAM COPY (PHASEIN). When using NEWCOPY command to reload programs, you must delete the compiled executable file before copying new compiled executable file to runtime environment. The supported CVDA value is CREATE.
Note: WEB EXTRACT (Server) Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Always returns HTTPYES. Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableCustomHTTPHeaders Enable SALT Property: enableHTTPRequestLine WEB RECEIVE (Server) Always returns HTTPYES. WEB SEND (Server) Enable SALT Property: enableHTTPRequestLine Enable SALT Property: enableCustomHTTPHeaders
•
• Some CICS commands require ARTSRM server. See ARTSRM Configuration for the complete set of those CICS commands.
•
Table 15‑2 CICS Command (C Support) ExternWriteOperator receives all parameters of the WRITE OPERATOR and simply returns zero in the return code and nothing else.It can be replaced by a customer function that respects the interface described below. The WRITE OPERATOR passes the following parameters and expects a return code in signed int format.Listing 15‑1 WRITE OPERATOR ParametersS9(9) COMP-5 is equivalent to a signed int.The parameters REPLY and REPLYLENGTH may be returned to the WRITE OPERATOR function if requested, that is to say, if MAXLENGTH > zero.Listing 15‑2 Example ExternWriteOperator.cbl CodeThe delivered ExternQuerySecurity stub receives all parameters of the QUERY SECURITY, it always allows access to the resources and returns zero in the return code. It can be replaced by a customer function that respects the interface described below.The QUERY SECURITY passes the following parameters:Listing 15‑3 Query Security Extern IntefaceListing 15‑4 Example COBOL Code for ExternQuerySecurity
2. Generate an "ExternQuerySecurity.o", and link it in ART servers (STRN, STR1, ATRN, ATR1, CTRN, CTR1).
3. In the makefile_intg (Cics_Rt/tools), add the "ExternQuerySecurity.o" in object variables for each server (STRN_OBJS, STR1_OBJS, ATRN_OBJS, ATR1_OBJS, CTRN_OBJS, CTR1_OBJS)
Table 15‑3 Supported EIB Fields
Note: recognized means function is not achieved, but there are no errors when doing MAPGEN compilation.
Notes:
Table 15‑4 ECI C API Parameters eci_program_name is the program name defined in programs.desc in ART CICS. If security is not enabled on ART CICS side, eci_userid is not checked on ECI Emulator. If security is not enabled on ART CICS side, eci_password is not checked on ECI Emulator. It cannot be NULL since no default system name is allowed.
Table 15‑5 CPIC Client C APIs to Support ART CICS CPI-C client use symbolic destination name set by cminit to specify remote CICS system ID. cmspln is a dummy function implemented in ART CICS CPI-C support. To specify remote CICS, please use cminit to set symbolic destination name.
Table 15‑6 CPIC Client JAVA APIs to Support ART CICS CPI-C client use symbolic destination name set by cminit to specify remote CICS system ID.