The following steps are a suggested checklist for installing a
TP that responds to an inbound request. Under each step is a specific
example of how a programmer named Jane installs a cooperative application
that is a database accessing program between
MVS and OS/2.
After the TP is loaded onto the system according to the directions
supplied with the application, follow these steps to provide the support
necessary to run the TP.
1. Start APPC
- Create an LU in an APPCPMxx parmlib member with an LUADD statement.
(See Adding a Local LU — LUADD Statement.)
Figure 1. ExampleJane decides to take all the defaults on her test run. She
codes a parmlib member named APPCPM22 and only codes the LU name on
the LUADD statement. Jane's APPCPM22 parmlib member looks something
like this:
LUADD
ACBNAME(MVSLU)
- Define a VSAM KSDS for TP profile information. (See Defining the VSAM Key Sequenced Data Sets (KSDS)
Figure 2. ExampleJane has no idea how large to make the TP profile file, so she
uses the sample definition she found in SYS1.SAMPLIB(ATBTPVSM).
- Specify the VSAM KSDS name in the APPCPMxx LUADD statement following
the TPDATA keyword parameter. (See Adding a Local LU — LUADD Statement.)
Figure 3. ExampleBecause Jane used the sample VSAM definition, the name of her
VSAM KSDS is SYS1.APPCTP. This is also the default name in the LUADD
statement. Therefore, Jane does not need to add anything to her parmlib
member APPCPM22.
- Code a VTAM® APPL definition
statement for the LU. (See Defining the Local LU to VTAM.)
Figure 4. ExampleJane uses the example APPL statement in SYS1.SAMPLIB member
ATBAPPL, and changes both the APPL name and the name of the LU to
MVSLU.
- Depending on whether the APPC address space was started, do one
of the following:
- If the APPC address space was not yet started, issue the START
command. (See Starting the APPC and ASCH Address Spaces.)
Figure 5. ExampleFrom an operator's console, Jane issues the following START
command:
START APPC,SUB=MSTR,APPC=22
- If the APPC address space was already started, issue the SET command.
(See Dynamically Changing the APPC/MVS Environment.)
Figure 6. ExampleFrom an operator's console, Jane issues the following SET command:
SET APPC=22
2. Start ASCH
- Create a class in an ASCHPMxx parmlib member with a CLASSADD statement.
(See Defining a Class — CLASSADD Statement.)
Figure 7. ExampleJane's program is a multi-trans TP that she wants to run continuously
in a class by itself. The expected response time goal for the TP
is 1/2 second. Jane codes a parmlib member named ASCHPM11 and defines
the class like this:
CLASSADD
CLASSNAME(DATA)
MAX(3)
MIN(1)
RESPGOAL(.5)
MSGLIMIT(1000)
OPTIONS
DEFAULT(DATA)
Jane includes the OPTIONS statement with DATA as the
default class.
- Depending on whether the ASCH address space was started, do one
of the following:
- If the ASCH address space was not yet started, issue the START
command. (See Starting the APPC and ASCH Address Spaces.)
Figure 8. ExampleFrom an operator's console, Jane issues the following START
command:
START ASCH,SUB=MSTR,ASCH=11
- If the ASCH address space was already started, issue the SET command.
(See Dynamically Changing the APPC/MVS Environment.)
Figure 9. ExampleFrom an operator's console, Jane issues the following SET command:
SET ASCH=11
3. Configure the peer system
For details,
see information about the peer system.
- Create a local LU.
Note: This local LU name is an MVS partner
LU name.
Figure 10. ExampleJane uses Communication Manager to create an APPC LU profile
for a local LU named PS2LU. She gives this LU name to her installation's VTAM programmer for use in the VTAM cross system configuration.
- Define the MVS logon modes on the peer system.
Figure 11. ExampleLogon modes
are called transmission service modes in OS/2. Jane defines a transmission
service mode for APPCPCLM, using the same name and the same parameter
values for the OS/2 parameters as was used in the original VTAM definition.
- Create a partner LU.
Note: This partner LU name must match the
MVS local LU name.
Figure 12. ExampleUsing the MVS local LU name MVSLU, Jane creates an APPC partner
LU profile on the OS/2. She adds the name of the transmission service
mode to the profile.
4. Create a TP profile
- Define a TP profile entry. (See Creating a TP Profile.)
Figure 13. ExampleJane defines a TP profile entry that takes the defaults except
for the parameters dealing with a multi-trans program. Her TP profile
looks like this:
TPNAME(TESTDATA)
TPSCHED_DELIMITER(##)
CLASS(DATA)
TPSCHED_TYPE(MULTI_TRANS)
GENERIC_ID(JANE)
JCL_DELIMETER(XX)
//TESTDATA JOB 'JANE',RWP,....
//STEP EXEC PGM=TESTDATA
//INPUT DD DSN=DATABASE.DATA,....
XX
##
- Add the TP profile to the TP profile file. (See Using the APPC/MVS Administration Utility and Using the APPC/MVS Administration Dialog
Figure 14. ExampleJane chooses to use the APPC administration utility because
the APPC administration dialog was not yet installed in TSO/E. She
issues a TPADD based on the multi-trans example she found in SYS1.SAMPLIB
member ATBUTIL.