Procedure for Installing TRSMAIN from the IBM FTP site to their OS/390 system.

TRSMAIN utility is used to compact documentation prior to FTP'ing it to IBM.
Using the TRSMAIN to compress data will save time when you are sending and receiving files.
TRSMAIN can also be used to uncompress files that have been compressed or packed.
If you have not installed the TRSMAIN program on your local OS/390 system, you can obtain a
copy of the TRSMAIN program using the FTP instructions below.

1.) FTP instructions for downloading the TRSMAIN program from the IBM FTP site.


   FTP ftp.software.ibm.com                  FTP to the host name ftp.software.ibm.com	

   USER: anonymous                           login as anonymous user with e-mail password
   PASSWORD: your complete e-mail address

   CD s390/mvs/tools/packlib                 go to the directory containing TRSMAIN
   BIN                                       to set up binary mode transmission
   LOCSITE RECFM=FB LRECL=80 BLKSIZE=3120
   GET TRSMAIN dtrsmain                      download TRSMAIN into a file called dtrsmain
   quit                                      get back into your TSO session

note:We called the TRSMAIN we downloaded using the get command as
dtrsmain, (for downloaded trsmain) but this file can be any name.

2.) Once the TRSMAIN program has been downloaded we must allocate a PDS (i.e. PACKLIB )
file with the following characteristics: We will call this PDS file PACKLIB


    Volume serial . . . .
    Generic unit. . . . .
    Space units . . . . . BLOCK
    Primary quantity. . . 24
    Secondary quantity. . 3
    Directory blocks. . . 1
    Record format . . . . U
    Record length . . . . 0
    Block size  . . . . . 13030
    Expiration date . . .

3.) Issue TSO RECEIVE INDSN(dtrsmain)
from your TSO session to convert the TRSMAIN program that we downloaded above into a load module format.

   The following messages will be displayed after the above command.

   INMR901I Dataset PTFLCG.TERSE409.LOADLIB from NHAN on PLPSC
   INMR902I Members: TRSMAIN
   INMR906A Enter restore parameters or 'DELETE' or 'END' +

   you should reply to INMR906A with the PDS name, which you allocated
   earlier, and member name - TRSMAIN.
   (i.e. DA(PACKLIB(TRSMAIN))

4) Once the PACKLIB is created , use the following sample JCL to create your own job
to compress/pack any file using TRSMAIN. 


   Here is the sample JCL to compress &input_dataset into its
   COMPRESSED format.

//PACKIT  JOB 'ACCOUNTING INFORMATION',NOTIFY=&SYSUID.
//****************************************************
//*                                                  *
//*       TRSMAIN with PACK option                   *
//*                                                  *
//****************************************************
//JOBLIB  DD   DISP=SHR,DSN=&PACKLIB
//STEP     EXEC PGM=TRSMAIN,PARM=PACK
//SYSPRINT DD   SYSOUT=H
//INFILE   DD   DISP=SHR,DSN=&input_dataset
//OUTFILE  DD   DISP=(NEW,CATLG),UNIT=SYSDAL,
//       DSN=&output_dataset,
//       SPACE=(CYL,(ppp,sss),RLSE)

The JOBLIB DD can be eliminated if the &PACKLIB is included in the LNKLST concatenation.

The &input_dataset in the INFILE DD must be modified with the proper dataset name that needs
to be compacted with the TRSMAIN utility.

The &output_dataset in the OUTFILE DD must be modified with the proper dataset
name that will contain the new packed/compressed file from the TRSMAIN utility.

The ppp and sss is the primary and secondary space for the output dataset

Once the JOB gets executed successfully, you should use the &packed_output in your FTP output process.

When you FTP this COMPRESSED dataset to the IBM Support center, please name that dataset that you just
packed/compressed with PACKED as the last qualifier, so IBM support personal knows to UNPACK/uncompress
this dataset after it is obtained.

5) Use the following sample JCL to create your own job
to unpack or decompress a file using TRSMAIN. 


   Here is the sample JCL to uncompress &input_dataset into its
   UNCOMPRESSED format.

//UNPACKIT  JOB 'ACCOUNTING INFORMATION',NOTIFY=&SYSUID.
//****************************************************
//*                                                  *
//*       TRSMAIN with UNPACK option                 *
//*                                                  *
//****************************************************
//JOBLIB  DD   DISP=SHR,DSN=&PACKLIB
//STEP     EXEC PGM=TRSMAIN,PARM=UNPACK
//SYSPRINT DD   SYSOUT=H
//INFILE   DD   DISP=SHR,DSN=&input_dataset
//OUTFILE  DD   DISP=(NEW,CATLG),UNIT=SYSDAL,
//       DSN=&output_dataset,
//       SPACE=(CYL,(ppp,sss),RLSE)

The JOBLIB DD can be eliminated if the &PACKLIB is included in the LNKLST concatenation.

The &input_dataset in the INFILE DD must be modified with the proper dataset name that needs
to be uncompacted with the TRSMAIN utility.

The &output_dataset in the OUTFILE DD must be modified with the proper dataset
name that will contain the unpacked/uncompressed file from the TRSMAIN utility.

The ppp and sss is the primary and secondary space for the output dataset