search cancel

Description of CTSSYNC IMPORT and EXPORT processing

book

Article ID: 134280

calendar_today

Updated On:

Products

CA 1 Tape Management

Issue/Introduction

This KB article describes the general steps involved with CTSSYNC IMPORT and EXPORT processing.

Cause

General processing steps involved with CTSSYNC IMPORT and EXPORT:

1) IMPORT or EXPORT control statements are passed to CTSSYNC, such as:

IMPORT,P00001,V11111,SCRATCH        (note - the first volser listed for IMPORT is the physical volume, the second is the virtual volume)

IMPORT,P00001,V22222,SCRATCH

etc. etc.

Or:

EXPORT,V11111,OFFSITE1

EXPORT,V22222,OFFSITE1

etc. etc.

2) CTSSYNC processing uses the IMPORT statements to generate 2 files: 1) an IMPORT list, 2) a response file. For example:

 13.54.36 JOB00361 IEC205I IMPORT,IMPORT,IMPORT,FILESEQ=1, COMPLETE VOLUME LIST, 422

    422 DSN=MYPROD.IMPORT.LIST.G0001V00,VOLS=vvvvvv,TOTALBLOCKS=84

 13.54.36 JOB00361 IEC205I IMPORT,IMPORT,IMPORT,FILESEQ=2, COMPLETE VOLUME LIST, 424

    424 DSN=MYPROD.IMPORT.LIST.G0001V00,VOLS=vvvvvv,TOTALBLOCKS=1

3) CTSSYNC processing uses the EXPORT statements to generate 3 files: 1) an EXPORT list, 2) a reserved file, 3) a response file.

4) The first file (IMPORT/EXPORT list) contains entries, such as:

IMPORT LIST 01

605175,100385,SCRATCH

605175,103724,SCRATCH

etc. etc.

Or:

EXPORT LIST 01

EXPORT,100385,OFFSITE1

EXPORT,103724,OFFSITE1

etc. etc.

5) The second file (IMPORT) contains an entry, such as:

IMPORT STATUS 01

6) The second file (EXPORT) contains an entry, such as:

RESERVED FILE

7) The third file (EXPORT only), contains an entry, such as:

EXPORT STATUS 01

8) CTSSYNC calls LCS services to schedule the IMPORT or EXPORT using:

         CBRXLCS TYPE=TAPE,

               FUNC=IMPORT (or EXPORT),

               VOLUME=wrkvol,

               CANCEL=NO,

               MF=(E,LCSLIST)

Where 'wrkvol' in this parmlist is the same volume as seen in the IEC205I messages above (this volume contains the IMPORT or EXPORT list, the associated response file, and for EXPORT, a required, reserved file).

9) This LCS call should complete with CC=0.

Some notes:

1) The above CBRXLCS call is identical to the MVS command LIBRARY IMPORT,vvvvvv or LIBRARY EXPORT,vvvvvv. In some cases where the IMPORT or EXPORT process fails, the user can manually enter the command 'LIBRARY IMPORT,vvvvvv' or 'LIBRARY EXPORT,vvvvvv' against the library manager, and this may produce additional diagnostic information used to reset the ATL (for example, the z/OS CBR3852I message may be issued which provides details for resetting the ATL via the commands 'LIBRARY RESET, CBRUXENT' and 'LIBRARY RESET, CBRUXEJC'. See the description of this message for additional details).

2) The CTSSYNC processing is the same as what is done using the sample JCL in SYS1.SAMPLIB(CBRSPSIM or CBRSPSXP ). This JCL uses IEBGENER to create the two or three files needed for IMPORT/EXPORT, as described above.

3) The IMPORT or EXPORT list volume is a logical volume residing in the same library as the volumes to be imported or exported.

4) When LCS is unable to schedule an IMPORT or EXPORT, the following user abend codes are generated: 1) U0100-00rs EXPORT command could not be scheduled, 2) U0200-00rs IMPORT command could not be scheduled. 'rs' is the Reason code from the 3495/3494 LCS services. It indicates why the EXPORT/IMPORT command could not be scheduled. The reason codes can be found in the LCS External Services Parameter List (LCSPL), mapped by IBM macro CBRLCSPL. This is used to pass parameters to the LCS external services, to pass return and reason codes and other information back to the caller. This macro can be found in SYS1.MACLIB. A U0999 with a dump may be issued if internal logical errors occur.

5) The following message from the IBM VTS (which is written to the host consoles) can be used to monitor the status of various VTS operations:

    CBR3750I Message from library library-name: message-text

    See the following online documentation for further details concerning this and other library manager messages: https://www.ibm.com/support/knowledgecenter/en/STFS69_3.0.1.3/3.0/ts7740_ua_operator_info.html

Environment

Release:


Component:

Resolution

See the 'Cause' description above for IMPORT/EXPORT processing details.