Description of CTSSYNC IMPORT and EXPORT processing
Article ID: 134280
Updated On:
Products
Issue/Introduction
This KB article describes the general steps involved with CTSSYNC IMPORT and EXPORT processing.
Environment
Release:
Component:
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
Resolution
Feedback
