Table 4‑1 Menu Groups The Main menu (BEAM) gives you access to all the maintenance screens.
Table 4‑2 Main Menu (BEAM) Sub-menu Codes
Table 4‑3 Main Menu (BEAM) Operation Codes
You can use the maintenance system screens to view and alter a connection, but not to insert (create) or delete a connection. Connections are created and deleted by TMA TCP for CICS in its normal operation.
Table 4‑4 Function Keys
Note: If you enter data and press PF3 or PF5 before pressing ENTER, the current operation process is aborted and the new screen is displayed.Use the UPDATE CONNECTION screen to update a record from the Connection file. When the screen initially displays, the LOGICAL MACHINE NAME and TYPE fields are unprotected. Enter a valid LOGICAL MACHINE NAME (gateway ID) and TYPE and press ENTER. The screen re-displays showing the data from the record you specified and the STATUS field is unprotected. The message RECORD READY FOR UPDATE displays. You can now make changes to the record.
For Requesters, this field name is the LMID associated with the service that the Requester is requesting.For a Handler, this field name is BEAH followed by the task number. The task number of the Handler is given in the BEALOG. The type of connection. Specify I for incoming connections or O for outgoing connections. The status of the connection. Specify E to enable the connection. Specify D for normal shutdown which allows initiated tasks to complete prior to disconnecting. Specify A for immediate shutdown which aborts all initiated tasks and disconnects. The task number of the Requester that is currently associated with the LOGICAL MACHINE NAME. If there is not an active Requester, the task number is for the Requester most recently associated with that LMID. Use this screen to inquire about a record from the Connection file. When the screen is initially displayed, the LOGICAL MACHINE NAME and TYPE fields are unprotected. Enter a valid LOGICAL MACHINE NAME (gateway ID) and TYPE and press ENTER. The screen is re-displayed with the data from the record you specified and the LOGICAL MACHINE NAME and TYPE fields are unprotected.
For Requesters, this name is the LMID associated with the service that the Requester is requesting.For a Handler, this name is BEAH followed by the task number. The task number of the Handler is given in the BEALOG. The type of connection. I represents incoming connections or O represents outgoing connections. The status of the connection. E means the connection is enabled. D means the connection is designated for a normal shutdown, which allows initiated tasks to complete prior to disconnecting. A means the connection shuts down immediately, aborts all initiated tasks, and disconnects. The task number of the Requester that is currently associated with the LOGICAL MACHINE NAME. If there is not an active Requester, the task number is for the Requester most recently associated with that LMID. To select a record for processing enter a valid selection code in the SEL CDE field. For example, to make an inquiry about a record, enter “3”. If you enter more than one selection code, the first one is used and all others are ignored. After the selection code is validated and processed, the screen for that process is displayed, and the record key appears in the LOGICAL MACHINE NAME field.
On the following maintenance screens, each instance of the Requester is given a logical machine ID (LMID). You can give a Requester any unique LMID that is meaningful to you. Every service name is associated with one LMID. This method allows the Requester to know which remote machine is responsible for a particular service.
Note: If you enter data and press PF3 or PF5 before pressing ENTER, the operation process is aborted and the appropriate screen is displayed.When the screen is first displayed, all the fields are unprotected. Type the required data, then press ENTER. After the data is validated and processed, the screen is re-displayed and all the fields are unprotected.
The TCP/IP dot address. Example: (199.99.99.99) The status of connection-level security. Y specifies that security is on and N denotes that security is off. The amount of time in seconds that a connection is idle before it is closed. IDLE TIME should be a smaller amount of time than REQ IDLE TIME. A typical setting is 30 seconds. The maximum number of connections the Requester opens. The maximum value is 50 for IBM TCP/IP. When the screen is first displayed, the LMID field is unprotected. Enter a logical machine name and press ENTER. The screen is re-displayed showing the data from the requested record. The HOST ADDRESS, PORT NUMBER, ACCOUNT ID, PASSWORD, MAX MSG SIZE, and CONNECT RETRY LIMIT fields are unprotected. The following message is displayed: RECORD READY FOR UPDATE.After the changes you entered are validated and processed, the screen is re-displayed and the LMID field is unprotected.
The TCP/IP dot address. Example: (199.99.99.99) The amount of time in seconds that a connection is idle before it is closed. IDLE TIME should be a smaller amount of time than REQ IDLE TIME. A typical setting is 30 seconds. The maximum number of connections the Requester opens. The maximum value is 50 for IBM TCP/IP. Use this screen to make an inquiry about a record from the Requester file. The screen is initially displayed with the LOGICAL MACHINE NAME field unprotected. Enter the logical machine name and press ENTER. The screen is re-displayed with the data from the requested record and the LOGICAL MACHINE NAME field is unprotected.
The TCP/IP dot address. Example: (199.99.99.99) The amount of time in seconds that a connection is idle before it is closed. IDLE TIME should be a smaller amount of time than REQ IDLE TIME. A typical setting is 30 seconds. The maximum number of connections the Requester opens. The maximum value is 50 for IBM TCP/IP.
WARNING: Deleting a Requester record can have serious ramifications. Think carefully before performing this operation. If there are any Service records that point to this GWID, any client calls to those services are rejected because Oracle TMA does not know to which remote machine the request should go.The screen is initially displayed with the LOGICAL MACHINE NAME field unprotected. Enter the logical machine name and press ENTER. The screen is then re-displayed with the data from the requested record and the LOGICAL MACHINE NAME field is protected. The following message is displayed: TO CONFIRM DELETE, PRESS ENTER AGAIN.
The TCP/IP dot address. Example: (199.99.99.99) The amount of time in seconds that a connection is idle before it is closed. IDLE TIME should be a smaller amount of time than REQ IDLE TIME. A typical setting is 30 seconds. The maximum number of connections the Requester opens. The maximum value is 50 for IBM TCP/IP. To choose a record, enter a valid selection code in the SEL CDE field next to that record. For example, to make an inquiry about a record, enter “3”. If you enter more than one selection code, the first one is used and the others are ignored.After the entry in the SEL CDE field is validated and processed, the screen for that process is displayed and the record key appears in the LOGICAL MACHINE NAME field.
A service is a name associated with some component of work. That component of work might be a banking transaction, an airline flight reservation, or an order for a dozen widgets. In Oracle Tuxedo, a client program that needs work done makes a “service request.” A process called a server performs the work described in the service request on behalf of the client, then returns the results of its efforts back to the client. In MVS this process would be referred to as a call to a “black box.”In a CICS application that uses TMA TCP for CICS, a service name is passed in the data area in an EXEC CICS LINK command and the results are returned in that same area. The service screens use the terms “service name” and “remote service name.” The service name (such as, CIC01XXYYZZ) is what the service is known as to your CICS environment and the remote service name (such as, WITHDRAWL) is what the service is known as to Oracle Tuxedo. For simplicity, you can make both names the same, but if naming conventions differ, you can use different names.
Table 4‑5 Function Keys
Note: If you enter data and press PF3 or PF5 before pressing ENTER, the operation process is aborted and the appropriate screen is displayed.Use this screen to insert a record into the service name file. The screen is first displayed with all fields unprotected. Enter the required data in the appropriate fields and press ENTER. After the data is validated and processed, the screen is re-displayed and all the fields are unprotected.
The status of request-level security. Y specifies that security is on and N denotes that security is off.Use this screen to update a record from the service name file. When the screen is first displayed, the SERVICE NAME field is unprotected. Enter the service name and press ENTER. The screen is then re-displayed with the data from the requested record and the LOGICAL MACHINE NAME, REMOTE SERVICE NAME, SERVICE TIMEOUT(SEC), and SECURITY fields are unprotected. The following message is displayed: RECORD READY FOR UPDATE.After the changes are validated and processed, the screen is re-displayed and the SERVICE NAME field is unprotected.
Use this screen to make an inquiry about a record from the SERVICE NAME file. The screen is initially displayed with the SERVICE NAME field unprotected. Enter the service name and press ENTER. The screen is re-displayed with the data from the requested record and the SERVICE NAME field is unprotected.
Use this screen to delete records from the service name file. The screen is initially displayed with the SERVICE NAME field unprotected. Type the service name and press ENTER. The screen is re-displayed with the data from the record requested and all the fields protected.The following message is displayed: TO CONFIRM DELETE, PRESS ENTER: AGAIN. After you press enter to confirm the deletion, the screen is re-displayed and the SERVICE NAME field is unprotected.
To select a record for processing, enter a valid selection code. For example, to make an inquiry about a record, enter “3”. If you enter more than one selection code, the first one is used, and the others are ignored. After the selection code is validated and processed, the screen for that process is displayed and the record key appears in the SERVICE NAME field.
A Handler is responsible for receiving service requests from the remote Oracle Tuxedo domain. The User Connection ACCOUNT screens allow for dynamic manipulation of accounts allowed to connect with a Handler when a Handler is configured with security enabled.
Table 4‑6 Function Keys
Note: If you enter data and press PF3 or PF5 before pressing ENTER, the operation process is aborted and the appropriate screen is displayed.Use this screen to add a new Connection ACCOUNT by inserting a new record into the user file.When the screen is first displayed, all the fields are unprotected. Type the required data as described in the table below, then press ENTER. After the data is validated and processed, the screen is re-displayed and all the fields are unprotected.
Use this screen to update a record on the account file. When the screen is first displayed, the ACCOUNT field is unprotected. Enter the account ID, and press ENTER. The screen is then re-displayed with the data from the requested record and the PASSWORD field is unprotected. The following message is displayed: RECORD READY FOR UPDATE.After the changes are validated and processed, the screen is re-displayed and the ACCOUNT field is unprotected.
Use this screen to make an inquiry about a record from the account file. The screen is initially displayed with the ACCOUNT field unprotected. Enter the ACCOUNT and press ENTER. The screen is re-displayed with the data from the requested record and the ACCOUNT field is unprotected.
Use this screen to delete a record from the account file. The screen is initially displayed with the ACCOUNT field unprotected. Type the service name and press ENTER. The screen is re-displayed with the data from the record requested and all the fields protected.The following message is displayed: TO CONFIRM DELETE, PRESS ENTER: AGAIN. After you press enter to confirm the deletion, the screen is re-displayed and the ACCOUNT field is unprotected.
To select a record for processing, enter a valid selection code. For example, to make an inquiry about a record, enter “3”. If you enter more than one selection code, the first one is used, and the others are ignored.
A service is a name associated with some component of work. That component of work can be a banking transaction, an airline flight reservation, or an order for a dozen widgets. In Oracle Tuxedo, a client program that needs work done makes a service request. A server performs the work described in the service request on behalf of the client, then returns the results of its efforts back to the client. In MVS this would be referred to as a call to a “black box.”The service screens use the terms LOCAL SERVICE NAME and REMOTE SERVICE NAME. The LOCAL SERVICE NAME (such as, CIC01XXYYZZ) is what the service is known as to your CICS environment and the REMOTE SERVICE NAME (such as, WITHDRAWL) is what the service is known as to Oracle Tuxedo. For simplicity, you can make both names the same; however, different names can be used. Changes to the inbound service file are only picked up when the Handler is restarted.
Table 4‑7 Function Keys
Note: If you enter data and press PF3 or PF5 before pressing ENTER, the operation process is aborted and the appropriate screen is displayed.Use this screen to insert a record into the service name file. The screen is first displayed with all fields unprotected. Enter the required data in the following fields and press ENTER. After the data is validated and processed, the screen is re-displayed and all the fields are unprotected.
For information about programming services without a reply, refer to the “Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS)” section.
Note: Services sending requests using a tpacall with the TPNOREPLY flag set must have a unique TRANSACTION NAME associated with it. Do not use the TRANSACTION NAME for the Application Handler program or an error message results. The status of security. Y enables security for the specified service and N disables security for the specified service.Use this screen to update a record in the inbound service name file. The screen is first displayed with the REMOTE SERVICE NAME field unprotected. Enter the remote service name and press ENTER. The screen is re-displayed with the data from the requested record and the LOCAL SERVICE NAME, TRANSACTION NAME, MAX MESSAGE SIZE, and SECURITY fields unprotected. The following message displays: RECORD READY FOR UPDATE.After the changes are validated and processed, the screen is re-displayed and the REMOTE SERVICE NAME field is unprotected.
For information about programming services without a reply, refer to the “Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS)” section.
Note: Services sending requests using a tpacall with the TPNOREPLY flag set must have a unique TRANSACTION NAME associated with it. Do not use the TRANSACTION NAME for the Application Handler program or an error message results. The status of security. Y enables security for the specified service and N disables security for the specified service.Use this screen to inquire about a record in the inbound service name file. The screen is first displayed with the REMOTE SERVICE NAME field unprotected. Enter the remote service name and press ENTER. The screen is re-displayed with the data from the requested record and the REMOTE SERVICE NAME field unprotected.
For information about programming services without a reply, refer to the “Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS)” section.
Note: Services sending requests using a tpacall with the TPNOREPLY flag set must have a unique TRANSACTION NAME associated with it. Do not use the TRANSACTION NAME for the Application Handler program or an error message results. Use this screen to delete a record in the inbound service name file. The screen is first displayed with the REMOTE SERVICE NAME field unprotected. Enter the remote service name and press ENTER. The screen is re-displayed with the data from the record requested and all fields protected. The following message displays: TO CONFIRM DELETE, PRESS ENTER AGAIN. After you press ENTER to confirm the deletion, the screen is re-displayed and the REMOTE SERVICE NAME field is unprotected.
The name of the CICS transaction that is started to process this service request. This service request is usually the transaction for the Application Handler program. For information about programming services without a reply, refer to the “Programming Oracle Tuxedo Mainframe Adapter for TCP (CICS)” section.
WARNING: Services sending requests using a tpacall with the TPNOREPLY flag set must have a unique TRANSACTION NAME associated with it. Do not use the TRANSACTION NAME for the Application Handler program or an error message results. To select a record for processing, enter a valid selection code. For example, to make an inquiry about a record, enter “3”. If you enter more than one selection code, the first one is used, and the others are ignored. After the selection code is validated and processed, the screen for that process is displayed and the record key appears in the REMOTE SERVICE NAME field.
Table 4‑8 Function Keys
Note: If you enter data and press PF3 before pressing ENTER, the operation process is aborted and the appropriate screen is displayed.
The status of gateway security. Y denotes that security is activated and N denotes that security is not activated. If this field is set to N, the ACCOUNT and PASSWORD fields are not verified prior to establishing a connection.
The status of gateway security. Y denotes that security is activated and N denotes that security is not activated. If this field is set to N, the ACCOUNT and PASSWORD fields are not verified prior to establishing a connection. You can dynamically configure outbound services by inserting a new record into the service name file, modifying an existing record in the service name file, or deleting a record in the service name file. Use the appropriate maintenance screens to accomplish the necessary task, S1 to insert, S2 to update, or S4 to delete. For field definitions, refer to the “The Outbound Service Information Screens” section.You can dynamically configure User Connection Accounts and enable accounts to connect to Handlers by inserting a new account into the user account file, modifying an existing user account, or deleting a user account. Use the appropriate maintenance screens to accomplish the necessary task, U1 to insert, U2 to update, or U4 to delete. For field definitions, refer to the “The User Connection ACCOUNT Screens” section.You can dynamically configure the status of a connection. Using the Update Connection screen (C2), you can enable, disable, or abort the connection for a given LMID. Dynamically configuring the status of a connection has an immediate effect on the corresponding Requesters. For field definitions, refer to the “The Connection Screens” section.
Note: Because the data in the Update Connection screen is transient, setting the LMID status to disable does not persist after the CICS region is shut down and then restarted. The Requester file, however, is persistent.Each instance of the Requester is given a logical machine name (LMID). You can give a Requester any unique LMID that is meaningful to you. Every service name is associated with one or more LMIDs. This method allows the Requester to identify which remote machine is responsible for a particular service. You can dynamically delete an LMID using the Update Requester screen (R2). This dynamic change only affect Pre-requesters immediately.Oracle Tuxedo has a set of tmadmin and dmadmin commands for the administration of the TMA TCP gateways. For detailed information about these commands, refer to the Oracle Tuxedo documentation.