|
|
|
The dialog comprises various ISPF Dialog Manager procedures, Assembler programs, panels, help panels, and message members, as well as supporting NCL procedures.
The main entry procedure that controls the dialog flow. It calls procedure NMFTSID, which sets installation options and then presents the FROM and TO panels to collect information regarding the user’s file transmission request. When all such information is available, it invokes one of three other procedures (NMFTSC, NMFTSM or NMFTSS, depending on the transfer option requested) to perform any actions related to the type of transfer.
This is invoked when the C option (direct copy) is selected and all information regarding regions and data sets is available. If the source data set is a PDS on the local system and no member name was supplied, a full member selection list is supplied. The TSO command processor NMCMD is then invoked to schedule the transmission request with the appropriate region.
This is invoked when the M option (direct copy specifying multiple members) is selected, and all information regarding regions and data sets is available. The source data set must be a PDS (verified if on the local system) and a panel is presented where you can enter up to 20 member names and new names, if they are to be renamed. The TSO command processor NMCMD is then invoked to schedule the transmission request with the appropriate region.
This is invoked when the S option (staged copy) is selected and all information regarding regions and data sets is available. If the source data set is a PDS on the local system and no member name is supplied, a full member selection list is supplied. For VSAM files a panel allowing selected key ranges (applicable to KSDS data sets) is presented. After allocating the necessary staging data sets, the TSO command processor NMCMD is invoked to schedule the transmission request with the local region.
This is an initialization procedure called from NMFTS when it is first invoked. It lets the installation specify various configuration options and defines the systems available for functions.
This is called from NMFTS to edit the system names provided by the user for the functions. It verifies that the system is valid and that the target system is accessible from the source system, based on the information supplied in procedure NMFTSID.
This is an Assembler program that is called to determine the data set organization of a requested data set. It expects the dialog variable &DSN1 to be in the shared variable pool and to contain the name (qualified or unqualified) of the data set in question. It sets a return code as follows:
Indicates that the function was successful.
Indicates that the data set was not cataloged.
For a return code of zero, NMFTDSRG sets the following dialog variables in the shared variable pool:
Defines the data set organization as one of the following:
Contains the actual volume on which the data set resides.
Contains the record format of the data set.
Contains the logical record length for the data set.
Contains the data set block size.
Contains the data set allocation units as CYLINDERS, TRACKS, or BLOCKS.
Contains the primary space allocation quantity.
Contains the secondary space allocation quantity.
This is a dialog program that uses ISPF Dialog Manager Table handling to provide a full member selection list for a PDS data set. It then processes selected members. Depending on the call parameters, it updates a sequential file with IEBCOPY control statements, or constructs the dialog variable &MEMSEL to reflect the selections (in the format expected by the MEMBERS operand of the FTSSEND subcommand of NMCMD). Members may be selected for file transfer with an S to copy the member, or an R to copy with rename, in which case a new member name must be supplied. The following parameters may be passed to NMFTMSEL:
Provides the DD name of the source data set for the file transmission. This indicates the data set from which the member selection list is built. If not present, a DD name of SYSUT1 is assumed.
Provides the DD name of the target data set for an IEBCOPY unload operation (usually the staging data set). If not specified, a DD name of SYSUT2 is assumed.
Provides the DD name of a data set that can be opened for update to contain the IEBCOPY control statements generated following user selections.
If not supplied, no data set is assumed. The dialog variable &MEMSEL contains the selections in the format expected by the MEMBERS operand of the FTSSEND subcommand of NMCMD.
May contain a single member name (for a single member unload operation) or an asterisk (*), which indicates that all members are selected. In either case, if a blank member value is entered, then a member selection list is presented.
The FROM panel, which prompts for source data set and system details, and is displayed on entering the system by procedure NMFTS.
The TO panel, which requests target data set and system details, and is displayed by procedure NMFTS.
This is displayed by procedure NMFTS when the target data set is specified to have a disposition of NEW.
This is used by the program NMFTMSEL to display the member selection list.
This is used by procedure NMFTSM to allow the entry of multiple member names when option M is selected for this request.
This is a confirmation panel. When a VSAM source file is requested to be transmitted to a new target file, an IDCAMS temporary export operation is assumed. This panel allows confirmation of this request before proceeding.
This is displayed by NMFTSC when a source VSAM data set is being transmitted to an existing target VSAM data set to allow the entry of key ranges restricting the records selected.
This is displayed by procedure NMFTSC when allocation of a new staging data set fails because it already exists. Options are provided to continue with the dialog and retry the operation, delete the data set and retry, or leave the data set and try allocating a different one.
This is displayed at your terminal when some delay can be expected while the transmission is scheduled.
This is displayed when the transmission request is aborted due to error and displays any messages returned.
This is displayed when the transmission was scheduled successfully.
These are the help panels.
NMFTM00, NMFTM01, and NMFTM02 contain ISPF messages used by the dialog.
The following NCL procedures are used by the ISPF Dialog. Each is invoked from the FRCMD or TOCMD operand on the NMCMD command. This means they are executed on successful completion of the requested transmission in the From, or sending, end and the To, or receiving, end, respectively.
This is invoked from $@L or $@M (see below) after successfully completing the staged transmission of an unloaded PDS data set. This procedure is executed to reload the transmitted members into the actual target data set and calls UTIL0009 to attach IEBCOPY.
This is invoked through FRCMD to delete a staging data set in the transmitting system and notify the TSO user of the successful transmission completion.
This is invoked through TOCMD to import a VSAM data set from a staging file that was transmitted as a temporary exported data set.
This is invoked through TOCMD to reload a PDS from a staging data set. This procedure is used when member replacement was not requested and sets a parameter before calling procedure $@COPY to perform the operation.
This is invoked through TOCMD to reload a PDS from a staging data set. This procedure is used when member replacement was requested and sets a parameter before calling procedure $@COPY to perform the operation.
A tailoring procedure that is called from several other NCL procedures to set any installation data set naming options.
This is invoked through FRCMD to notify the TSO user of the successful completion of the transmission.
This is invoked through TOCMD to reload a VSAM file following a staged transmission through the standard IDCAMS REPRO function. This procedure allows record replacement and merely sets a parameter before calling procedure $@REPRO to perform the operation.
This is invoked from $@R or $@S and calls UTIL0007 to attach the IDCAMS system utility and perform a REPRO load operation.
This is invoked through TOCMD to reload a VSAM file following a staged transmission through the standard IDCAMS REPRO function. This procedure does not allow record replacement and sets a parameter before calling procedure $@REPRO to perform the operation.
| Copyright © 2010 CA. All rights reserved. |
|