CICS Access. Xptr-JHS

Transcription

1 CICS Access Xptr-JHS

2 COPYRIGHT Licensed Materials - Property of Systemware, Inc. Copyright Systemware, Inc., All rights reserved. Use, duplication, or disclosure restricted by contract with Systemware, Inc. DISCLAIMER Systemware, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without the obligation of Systemware, Inc. to notify any person of such revision or changes. Systemware cannot be responsible for product problems caused by unsupported versions of operating system software or other vendor software such as application-server or Web software packages. TRADEMARKS Systemware, the Systemware logo, and all Systemware product components and logos are either registered trademarks or trademarks of Systemware, Inc. All other trademarks are the properties of their individual owners. DOCUMENTATION AND TECHNICAL SUPPORT The following documentation comprises the Systemware package for Xptr and related software: Xptr Administrator s Guide SD Xptr Operator s Guide SD Xptr User s Guide SD JHS Administrator's Guide SD JHS User's Guide SD JHS Operator's Guide SD Implementation Guide R4.1 SD Implementation Guide R4.2 SD System Manual SD Message Manual SD JCL Utilities SD Installation Manual SD For information regarding this documentation or to inquire about receiving additional documentation, contact: documentation@systemware.com Systemware, Inc., Dallas Parkway, Suite 1100, Addison, Texas For product or technical support and other information, contact Systemware: Phone (972) Customer Support hotline phone (972) ; fax techsupport@systemware.com Web site Customer information portal (includes support FAQ and problem reporting procedures) SD (March 2007) AUDIENCE This manual is intended for persons involved in operating and maintaining Systemware software. The procedures discussed in this manual assume a knowledge of z/os utilities, JCL, VSAM, and CICS. Persons requiring detailed knowledge of the implementation and ongoing administration of Systemware Program Products should refer to the appropriate Administrator's manuals.

3 Contents CICS access 5 Method 5 Terminal user operation 5 CICS resource usage 5 License activation code (LAC) 6 Installating CICS access 6 VTAM requirement 6 Update CICSMBR 6 CICS requirement 6 Update CICS tables 6 Review JHSPRM00 8 Security 9 Console operator commands 10 ACTivate CICS CONNection 10 DISConnect CICS CONNection 10 Display CICS CONNections 10 INSTLIB(CICSMBR) 12 CICS Access (March 2007) 3

4 4 Systemware, Inc.

5 CICS access The CICS interface provides CICS terminal users access to Systemware Program Products Xptr and JHS. Either of these program products can be substituted where the term 'Xptr' is used in this document. The CICS access option requires its own license activation code to enable its operation. Refer to the section entitled License Activation Code. Method The method employed for this access is to use the CICS Inter-System Option (ISC) to communicate with Xptr. In this manner, Xptr appears to CICS to be an Application Owning Region (AOR). This allows the terminal user to see the same Xptr screens as the TSO or VTAM user, while keeping the overhead in CICS at a minimum. Terminal user operation In order to access Xptr from a terminal, a user must be signed on to CICS and must enter the XPTR transaction code from a clear screen. Any data following the transaction code is interpreted as the initial Xptr command. Once a session is started, all terminal input and output is passed to Xptr until the session is ended. To end the Xptr session, use the PFK3 key from Main Activities screen. The terminal is then returned to normal CICS operation. While a session is active, it is subject to the terminal time-out feature of Xptr, and is canceled after a period of inactivity. CICS resource usage The implementation method is designed so that there are no program or file resources added to a CICS region. These facilities and the corresponding overhead reside in the Xptr address space. The only updates to CICS tables are one entry in the Terminal Control Table (TCT), and one entry in the Program Control Table (PCT). The storage overhead for this interface is identical to any TOR/AOR connection using the Transaction Routing function of CICS. CICS Access (March 2007) 5

6 License activation code (LAC) License activation code (LAC) The License Activation Code system parameter is required to operate the CICS access option. The parameter has the following specifications: CICSLICENSECODE Purpose: License activation code Value: 20 characters Default: None Desc: The parameter value must be present for feature activation. The parameter value is supplied by Systemware as part of feature evaluation and licensing. Installating CICS access VTAM requirement In order to access Xptr from one or more CICS regions, you must install Xptr with native VTAM access as described in the appropriate program product System Manual. This is due to the fact that the CICS interface is a subset of the VTAM interface. In addition, the VTAM application definition must specify the following options: AUTH=(ACQ,PASS),PARSESS=YES,SONSCIP=YES Update CICSMBR Review and modify member CICSMBR of INSTLIB to reflect your installation requirements. Refer to Appendix A for a description of CICSMBR. CICS requirement Each CICS region that interfaces to Xptr must be configured for ISC using VTAM's LU 6.2 (APPC) communication. In addition, the Terminal Control Program (TCP) must support interconnection using APPC protocols. This is available in a number of the pre-generated TCP modules. Refer to vendor CICS documentation for more information. Update CICS tables Make the following CICS table changes to each region that is to access Xptr. 6 Systemware, Inc.

7 CICS access Changes to the TCT RDO Method Connection Entry CONNECTION(cccc) NETNAME (nnnnnnnn) PROTOCOL(APPC) SINGLESESS(NO) AUTOCONNECT(yes/no) ATTACHSEC(IDENTIFY) Not Session Entry SESSIONS(cccc) CONNECTION(cccc) MODENAME(mmmmm mmm) PROTOCOL(APPC) MAXIMUM(nnn,nnn) Note AUTOCONNECT(yes/no) MACRO Method DFHTCT TYPE=SYSTEM, TRMTYPE=LUTYPE62, ACCMETH=VTAM, BUFFER=4096, RUSIZE=4096, NETNAME=nnnnnnnn, SYSIDNT=cccc, USERSEC=IDENTIFY, Note 2 CONNECT=AUTO DFHTCT TYPE=MODESET, SYSIDNT=cccc, MODENAME=mmmmm mmm, MAXSESS=(nnn,nnn), Note CONNECT=AUTO Recommended Value same as SYSTEMNAME in JHSPRM00 must match VTAMACBNAME in JHSPRM00 YES same as SYSTEMNAME in JHSPRM00 must match connection name above ISTNLDM same as LOGMODE SESSIONS in CICSMBR YES Recommended Value must match VTAMACBNAME in JHSPRM00 same as SYSTEMNAME in JHSPRM00 same as SYSTEMNAME in JHSPRM00 ISTNLDM same as LOGMODE SESSIONS in CICSMBR CICS Access (March 2007) 7

8 Installating CICS access Note: 1 The MAXIMUM or MAXSESS specification is coded as two values. Both values must be equal. 2 Required for CICS release 3.3 and above. Changes to the PCT RDO Method TRANSACTION(tttt) REMOTESYSTEM (cccc) MACRO Method DFHTCT TYPE=REMOTE, SYSIDNT=cccc, TRANSID=cccc Recommended Value same as SYSTEMNAME in JHSPRM00 must match connection name above Recommended Value same as SYSTEMNAME in DFHTCT entry same as SYSTEMNAME in JHSPRM00 Changes to the SIT Insure that the SIT specifies the following option: ISC=YES, Review JHSPRM00 Review member JHSPRM00 of INSTLIB, and make any appropriate changes. The following parameters should have been generated during the online question procedure. CICSLICENSECODE 20 hexadecimal characters Use the license code value supplied by SYSTEMWARE for your site. CICSLOGONEXIT eeeeeeee Use sample exit JHSCLMX1 to pass security information to Xptr. CICSLOGONSCREEN ssss Refer to the section 'SECURITY' for a discussion of the parameter. CICSMBR cccccccc Sample member name is CICSMBR in INSTLIB. 8 Systemware, Inc.

9 CICS access Security The CICS interface is designed to maintain the same level of security for the terminal user that is in effect under CICS. This is accomplished by extracting the userid from CICS and using it to logon to Xptr. In this manner, the terminal user is identified to Xptr using the same security userid as in CICS, without having to re-enter their security information. This capability is known as a transparent logon and is similar to the TSO security access. In order to utilize the transparent logon method, you must specify the following system parameters in JHSPRM00 of INSTLIB: CICSLOGONMSGEXIT SECURITYEXIT JHSCLMX1 JHSSECxx where, xx = 10 for TOP SECRET 14 for RACF 15 for ACF2 CICSLOGONSCREEN L30p where, p = J for JHS X for Xptr In addition, you must modify the sample security exit JHSSECxx to include the ACB names of all CICS regions that will access Xptr. Refer to the comments in the member JHSSECxx in JHSASM for details on the table additions. The sample exit JHSCLMX1 is used to extract the userid from the transaction data passed from CICS. This userid is passed to the security exit to use for the logon. The sample security exit JHSSECxx is used to verify the userid passed from JHSCLMX1, with the security manager. This is only in effect if the CICS ACB name is in the table of secured applications. This table is used to distinguish CICS users from native VTAM users. Refer to the comments in the JHSSECxx member of JHSASM for more information. The L30p logon screen is used to allow the terminal user to specify an Xptr user name on the initial transaction or following the "L" command. In either case, the userid passed from CICS is used for the logon, and cannot be overridden from this screen. CICS Access (March 2007) 9

10 Console operator commands Console operator commands The following operator commands affect the operation of the Xptr CICS interface and are in addition to the basic Xptr commands as described in the Xptr Operator s Guide. Each CICS connection is identified with a four character connection name assigned during installation, and is used in the CICS operator commands. ACTivate CICS CONNection The ACTivate CONNection command is used to enable the communication interface between Xptr and a CICS region. The connection is normally activated automatically when either Xptr or CICS is started. This command can be used to restart a connection that was stopped normally or by an error situation. In order for a connection to be started, the CICS region must be active and accepting logons, and the connection must be in the "DISC" state. The syntax for the ACTivate CONNection command is as follows: F XPTRMAIN,ACT CONN <connection name> where <connection name> is the four character name for this connection assigned during installation. The command responds with message "SW#0239I... STARTED" if successful, or messages SW#0238I or SW#0239I if an error occurred. DISConnect CICS CONNection The DISConnect CONNection command is used to disable the communication interface between Xptr and a CICS region. The connection is normally disconnected automatically when either Xptr or CICS is stopped. This command can be used to stop communications between Xptr and CICS without stopping either system. In order for a connection to be stopped, the connection must be in the "ACT" state. The syntax for the DISConnect CONNection command is as follows: F XPTRMAIN,DISC CONN <connection name> The command responds with message "SW#0239I... STOPPED" if successful, or messages SW#0238I or SW#0239I if an error occurred. In certain error situations a connection will not stop normally. In these cases the FORCE option of the DISConnect command can be used. This option should be a last resort effort to terminate a connection. The syntax for the DISConnect FORCE command is as follows: F XPTRMAIN,DISC CONN <connection name> FORCE The command responds with message "SW#0239I... STOPPED" when all sessions for the connection have been stopped. Display CICS CONNections The Display CONNections command is used to obtain a status display of all CICS connections. The syntax of the command is as follows: F XPTRMAIN,D CONN The command responds with message SW#0243I for each connection indicating the communication status, maximum number of sessions, and active number of sessions. 10 Systemware, Inc.

11 CICS access The communication status is defined as follows: ACT DISC PNDACT PNDDSC connection is active and enable connection is inactive and disabled connection is in the process of being activated connection is in the process of being disconnected CICS Access (March 2007) 11

12 INSTLIB(CICSMBR) INSTLIB(CICSMBR) In the main parameter list member (JHSPRM00 by default), the CICSMBR parameter specifies the member name that specifies parameters for the CICS access option. Multiple sets can be specified. CICS CONNECTION DEFINITIONS THIS MEMBER NAMES AND DEFINES THE LU62 CONNECTIONS TO CICS. EACH CONNECTION CONTAINS A CONNECTION GROUP AND ONE OR MORE LOGMODE GROUPS. A CONNECTION GROUP STARTS WITH A "CONNECTIONNAME' STATEMENT. A LOGMODE GROUP STARTS WITH A "LOGMODENAME' STATEMENT. THE STRUCTURE OF THE STATEMENTS IS AS FOLLOWS: CONNECTIONNAME <CICS DEFINITION #1> ACBNAME. AUTOSTART. PSEUDOCONV. RETURNTRAN. LOGMODENAME. <LOGMODENAME GROUP #1> LOGMODESESSIONS.. CONNECTIONNAME <CICS DEFINITION #2> ACBNAME. AUTOSTART. PSEUDOCONV. LOGMODENAME. <LOGMODENAME GROUP #1> LOGMODESESSIONS.. LOGMODENAME. <LOGMODENAME GROUP #2> LOGMODESESSIONS.. THE SPECIFICATIONS OF THIS MEMBER CAN BE DYNAMICALLY UPDATED WITH THE SP (SETPARM) COMMAND SUBJECT TO THESE RESTRICTIONS: 1. CONNECTIONS MAY BE ADDED. 2. CONNECTIONS MAY BE REPLACED IF THEY ARE INACTIVE. 3. CONNECTIONS CAN NOT BE DELETED. 4. PARTIAL UPDATES TO CONNECTIONS MAY BE MADE BY UPDATING AND REPLACING AN INACTIVE CONNECTION. CICS DEFINITION MEMBER FORMAT: COMMENTS ARE IDENTIFIED BY AN ASTERISK (*) IN COLUMN 1 COMMENTS CANNOT BE PLACED ON OTHER RECORDS. MORE THAN ONE CONNECTION CAN BE DEFINED. EACH CONNECTION BEGINS WITH THE "CONNECTIONNAME" PARAMETER. GENERAL STATEMENT FORMAT: 1. OPTION NAME STARTING IN COL OR MORE BLANKS 3. OPTION VALUE THE OPTIONS THAT APPLY TO THE CONNECTION GROUP ARE: CONNECTIONNAME (REQUIRED) PROVIDES A NAME FOR THIS CONNECTION TO BE USED AS AN IDENTIFIER IN COMMANDS AND MESSAGES. IT IS RECOMMENDED THAT THIS NAME MATCH THE "SYSIDNT" NAME THAT IS CODED IN THE CICS DFHSIT TABLE OR IN OPTIONAL SYSIN OVERRIDES. 12 Systemware, Inc.

13 CICS access VALUES: 1-4 CHARACTERS ACBNAME (REQUIRED) THE ACB NAME THAT DEFINES THE REMOTE CICS TO VTAM. THIS NAME MUST MATCH THE "APPLID" NAME THAT IS CODED IN THE CICS DFHSIT TABLE OR IN OPTIONAL SYSIN OVERRIDES. VALUES: 1-8 CHARACTERS AUTOSTART DESCRIBES HOW TO TREAT THIS CONNECTION WHEN THE DATABASE ADDRESS SPACE IS STARTED. VALUES: YES - ATTEMPT TO CONNECT TO CICS AUTOMATICALLY NO - WAIT FOR OPERATOR OR CICS TO START THE CONNECTION. THE DEFAULT VALUE IS NO. PSEUDOCONV DESCRIBES WHETHER THE OPERATION OF THE CICS TRANSACTION IS PSEUDO-CONVERSATIONAL OR CONVERSATIONAL. IN THE PSEUDO-CONVERSATIONAL MODE OF OPERATION, THERE WILL BE NO ACTIVE CICS TASKS RUNNING WHILE WAITING FOR TERMINAL INPUT. THIS HAS THE EFFECT THAT PARAMETER "LOGMODESESSIONS" NEED ONLY REFLECT THE NUMBER OF USERS THAT ARE SIMULTANEOUSLY PROCESSING TERMINAL INPUTS. VALUES: YES - USE THE PSEUDO-CONVERSATIONAL MODE OF OPERATION. NO - USE THE CONVERSATIONAL MODE OF OPERATION. THE DEFAULT VALUE IS YES. THE OPTIONS THAT APPLY TO THE LOGMODE GROUP ARE: RETURNTRAN SPECIFIES THE OPTIONAL TRANSACTION NAME THAT SHOULD BE RUN WHEN THE USER ENDS OUT OF THE SYSTEMWARE STARTED TASK. THE DEFAULT IS NONE, WHICH CAUSES THE SYSTEMWARE STARTED TASK TO RETURN CONTROL TO CICS. LOGMODENAME (AT LEAST ONE REQUIRED) THE NAME OF THE VTAM LOGMODE ENTRY TO ESTABLISH SESSION PARAMETERS FOR THIS CONNECTION. VTAM LU62 PROTOCOL REQUIRES A LOGMODE NAME IN ORDER TO ESTABLISH A SESSION. NOTE, THE SESSION PARAMETERS CODED IN THE LOGMODE ENTRY ARE IGNORED AND OVERRIDDEN BY CICS TO INSURE A VALID LU62 SESSION. THEREFORE ONLY THE CLASS-OF-SERVICE INFORMATION IS SUPPLIED BY THE LOGMODE ENTRY. IF DESIRED, YOU MAY USE A IBM DEFAULT ENTRY SUCH AS "ISTNLDM" TO AVOID HAVING TO ADD A NEW LOGMODE ENTRY TO VTAM. VALUES: 1-8 CHARACTERS LOGMODESESSIONS (REQUIRED) A NUMERIC VALUE SPECIFYING HOW MANY SESSIONS TO ESTABLISH BETWEEN CICS AND THE DATABASE ADDRESS SPACE. IF PARAMETER "PSEUDOCONV" IS SET TO NO, THEN THIS VALUE SHOULD REFLECT THE NUMBER OF LOGGED ON USERS TO THE DATABASE ADDRESS SPACE. IF PARAMETER CICS Access (March 2007) 13

14 INSTLIB(CICSMBR) "PSEUDOCONV" IS SET TO YES, THEN THIS VALUE SHOULD REFLECT THE NUMBER OF USERS WHO ARE SIMULTANEOUSLY PROCESSING INPUT REQUESTS. VALUES: THE DEFAULT VALUE IS 5 14 Systemware, Inc.