4.2.1 Task 1: Allocate z/OS Datasets

The directory structures on the TMA TCP for IMS software CD include the following partitioned datasets:

Partitioned Datasets (PDS)	Format	Contents
CONTROL	ASCII	Sample IMS definitions, sample Oracle TMA TCP for IMS configuration files
INCLUDE	ASCII	C header files, COBOL copybooks for use by IMS Client and Server transactions
JCL	ASCII	Job Control Language for linking and executing Oracle TMA TCP for IMS
SOURCE	ASCII	Sample IMS Client and Server transactions for use with Oracle TMA TCP for IMS
OBJECT	BINARY	Object component files of Oracle TMA TCP for IMS
MSGCAT (sequential dataset)	BINARY	File containing runtime messages that TMA TCP for IMS issue

1. FTP the JCL file INSTALL from the JCL subdirectory.
2. Execute this job to allocate datasets using high-level qualifiers appropriate to your installation (hlq1 and hlq2 are dataset name high-level qualifiers appropriate to your installation).

   The following datasets are allocated to receive the Tuxedo Mainframe Adapter for TCP file distribution.

The following datasets are allocated to receive the Tuxedo Mainframe Adapter for TCP file distribution.

Listing 4‑1 Allocating z/OS Datasets

DSNAME: hlq1.hlq2.CONTROL
DSORG: PO
DIRBLKS: 10
RECFM: FB
LRECL: 80
BLKSIZE: 23440 (or other valid blocksize)
SPACE: 2 tracks
Usage: IMS sample definitions, sample configuration file
DSNAME: hlq1.hlq2.INCLUDE
DSORG: PO
DIRBLKS: 10
RECFM: FB
LRECL: 80
BLKSIZE: 23440 (or other valid blocksize)
SPACE: 2 tracks
Usage: C header file, COBOL copybooks
DSNAME: hlq1.hlq2.JCL
DSORG: PO
DIRBLKS: 10
RECFM: FB
LRECL: 80
BLKSIZE: 23440 (or other valid blocksize)
SPACE: 2 tracks
Usage: Sample LINK and execute JCL
DSNAME: hlq1.hlq2.MSGCAT
DSORG: PS
DIRBLKS: 10
RECFM: FB
LRECL: 100
BLKSIZE: 32000 (or other valid blocksize)
SPACE: 2 tracks
Usage: Message text
DSNAME: hlq1.hlq2.OBJECT
DSORG: PO
DIRBLKS: 10
RECFM: FB
LRECL: 80
BLKSIZE: 3200
SPACE: 1 cylinder
Usage: Pre-linked object files
DSNAME: hlq1.hlq2.SOURCE
DSORG: PO
DIRBLKS: 10
RECFM: FB
LRECL: 80
BLKSIZE: 23440 (or other valid blocksize)
SPACE: 1 track
Usage: Sample IMS client and server transactions

The following runtime datasets are also allocated.

Runtime Datasets	Format	Contents
LOAD	Binary	Load library for Oracle TMA TCP for IMS
CONFIG	ASCII	Configuration file for Oracle TMA TCP for IMS
MSGLOG	ASCII	Message log for Oracle TMA TCP for IMS
SVRLOG	ASCII	A log file containing server responses for Oracle TMA TCP for IMS

Listing 4‑2 Allocating Runtime Datasets

DSNAME: hlq1.hlq2.LOAD
DSORG: PO
DIRBLKS: 10
RECFM: U
LRECL: 0
BLKSIZE: 6133 (or other valid blocksize)
SPACE: 1 cylinder
Usage: Load library
DSNAME: hlq1.hlq2.CONFIG
DSORG: PS
RECFM: FB
LRECL: 80
BLKSIZE: 23440 (or other valid blocksize)
SPACE: 1 track
Usage: Configuration File
DSNAME: hlq1.hlq2.MSGLOG
DSORG: PS
RECFM: VB
LRECL: 1028
BLKSIZE: 6144 (or other valid blocksize)
SPACE: 1 cylinder
Usage: Message Log
DSNAME: hlq1.hlq2.SVRLOG
DSORG: PS
RECFM: VB
LRECL: 32756
BLKSIZE: 32760 (Note: required blocksize)
SPACE: 1 cylinder
Usage: Server Response Log