|
|
|
The FTSDEF subcommand lets TSO users create and store CA SOLVE:FTS definitions in the VFS database. No file transmission activity results from the definition, but a subsequent transmit request can be used to request the transmission.
FTSDEF NAME( ftsname ) [ COPY( ftsdef ) ] DEST( ftsdest ) [ CLASS( ftsclass ) ] FRDSN( fromdsn ) [ FRDSP( OLD | SHR ) [ FRVOL( fromvol ) FRUNT( fromunit ) ] [ MEMBERS( mem1 [ /ren1 ], mem2 [ /ren2 ], ... ) ] TODSN( todsn ) [ TODSP( OLD | SHR | MOD | NEW | REP ) ] [ TOVOL( tovol ) ] [ TOUNT( tounit ) ] [ TOSPC( units pri sec dir ) ] [ TORFM( torecfm ) ] TOBLK( toblksize ) ] TOLRL( tolrecl ) ] [ TIMCO( Y | N ) TODSN( ‘SYSOUT’ ) [ SOCLS( class ) ] [ SOCOP( copies ) ] [ SOHLD( N | Y ) ] [ SODST( dest ) ] [ SOFLD( N | Y ) ] [ SOFRM( forms ) ] [ SOFCB( fcb ) ] [ SOUCS( ucs ) ] [ SOPGM( program ) ] [ MSG | NOMSG ] [ PRIVATE | SYSTEM ] [ FRCMD( ‘from command ’ ) ] [ TOCMD( ‘to command ’ ) ] [ GROUP( groupid ) ] [ UDATA( ‘user data’ ) ] [ FRXMIT( ftsdef ) ]
(Mandatory) Provides the name for this file definition. The name can be up to 12 characters long. However, if the MEMBERS keyword (see description below) is also specified, then the specified name should not exceed 10 characters.
This name must be unique in the region to which you are connected, otherwise, the request will fail. As distributed, the CA SOLVE:FTS procedures restrict all such names to only those beginning with the user’s user ID, regardless of the user’s privileges. Check with your installation representative or system administrator for any name restriction changes.
(Optional) Provides the name of an existing transmission definition to copy. If used, the only other operands that need to be specified are those differing from the copied transmission definition. However, DEST(*), TODSN(*), and FRDSN(*) must be specified to copy the destination, ‘To’ data set, and ‘From’ data set respectively because those operands are mandatory.
Note: The COPY operand should be preceded only by the NAME operand because any intervening operand values are lost.
(Mandatory) Provides the name of the destination where this transmission is to be sent.
Limits: 1 to 12 characters
(Optional) Provides the transmission class for this request (any character A to Z). If not specified, then the default is class A, unless the MEMBERS operand is also specified, when the default is class M.
Specifies the name of the ‘From’ or source data set to be transmitted to the target region. This can be any valid data set name and may include a PDS member name, unless the MEMBERS keyword is also specified (see the MEMBERS operand below for details). When using TSO data set prefixing, the first level qualifier can be omitted because it is automatically inserted by the command processor, unless the data set name is enclosed in quotation marks. If the data set is not cataloged, FRVOL and FRUNT operands must be present.
Specifies the disposition of the fromdsn data set.
Specifies the volume serial information of the fromdsn data set if it is not cataloged. If this operand is specified, the FRUNT operand must also be present.
Specifies the unit information (for example, TAPE, SYSDA, and so on) of the fromdsn data set if it is not cataloged. If this operand is specified, then the FRVOL operand must also be present.
Allows a member list to be entered for PDS data sets. This operand is mutually exclusive with the specification of a member in the fromdsn data set name. Up to 99 members may be present in the list. Any members can be renamed in the target data set by specifying the list entry as mem/ren where mem is the member name in the fromdsn and ren is the new name to be given in the todsn. Each member in the list is transmitted in a separate transmission. The ftsname provided by the NAME operand should not exceed 10 characters if the MEMBERS operand is used because each actual request after the first one generates a name consisting of the ftsname suffixed by two digits (02-99).
(Mandatory) Receives the transmitted file. If the name specified is ‘SYSOUT’, the fromdsn data set is transmitted directly to the JES spool. In this case, no other operands that begin with TO should be present, but those beginning with SO may provide any required SYSOUT options. If a todsn data set name is supplied, it must be compatible with the fromdsn according to the usual requirements.
Provides the disposition of the ‘To’ or target data set. Unless NEW or REP is specified, then the todsn entered must be a cataloged data set at the destination. Otherwise, the TOVOL, TOUNT, TOSPC, TOLRL, TOBLK, and TORFM operands must provide the new data set information. The REP option is treated as NEW except that the data set is deleted and replaced if it exists already.
Provides the volume serial information of the todsn when TODSP is NEW or REP. The new data set is created and cataloged on this volume. If this operand is omitted for a new data set, then the TOUNT operand must be specified and the destination will create the data set on any suitably authorized volume for the tounit.
Provides the unit information of the todsn when TODSP is NEW or REP. If it is not supplied for a new data set, then the TOVOL operand must be present and the default unit value for the tovol is used.
Provides the units of space allocation and the various quantities for a new data set only (that is, where TODSP is specified as NEW or REP). The units may be one of CYLS, TRKS, or BLKS to request cylinder, track, or block allocation respectively.
The quantities pri, sec, and dir may be any 1-5 digit numbers that provide the primary, secondary, and directory block allocation quantities. Both units and pri must be present, while sec and dir default to zero. Unless a PDS member transmission was requested, no directory block information should be supplied.
Provides the record format where the todsn is new or an image copy is not requested (that is, TIMCO=N is specified). It may be any one of F, FB, FBA, FA, FM, V, VB, VBA, VBM, VA, VM, VS, VBS or U. If TORFM is specified, then TOLRL and TOBLK must also be present.
Provides the block size as a 1 to 5 digit number for new todsn data sets or where an image copy is not requested (that is, TIMCO=N is specified). If TOBLK is specified, then TOLRL and TORFM must also be present.
Provides the logical record length as a 1 to 5 digit number for new todsn data sets or where an image copy is not requested (that is, TIMCO=N is specified). If TOLRL is specified, then TOBLK and TORFM must also be present.
Indicates whether an image-copy transmission is requested. If Y is specified, the DCB attributes of the todsn are copied from the fromdsn; otherwise, they must be supplied. The default for image-copy is Y except where the DCB information is supplied (in tolrl, toblksize and torecfm) in which case it is set to N.
(Optional) Provides the SYSOUT class if TODSN(SYSOUT) is specified, and defaults to A.
(Optional) Provides the 1 to 3 digit number of SYSOUT copies required if TODSN(SYSOUT) is specified, and defaults to 1.
Indicates whether the SYSOUT data set is to be placed in HOLD when TODSN(SYSOUT) is specified.
(Optional) Provides the 1 to 8 character SYSOUT destination if TODSN(SYSOUT) is specified.
Indicates whether the output is to have the FOLD option when TODSN(SYSOUT) is specified.
(Optional) Provides the 1 to 4 character SYSOUT forms name if TODSN(SYSOUT) is specified.
(Optional) Provides the 1 to 4 character SYSOUT FCB name if TODSN(SYSOUT) is specified.
(Optional) Provides the 1 to 4 character SYSOUT UCS name if TODSN(SYSOUT) is specified.
(Optional) Provides the 1 to 8 character program name to process SYSOUT if TODSN(SYSOUT) is specified.
Indicates whether returned messages are written to the TSO terminal using PUTLINE macros. Error messages about session I/O cannot be suppressed by this operand.
Determines whether this transmission request is a PRIVATE or SYSTEM request.
Default: PRIVATE
Note: The user’s privilege does not affect the definition of this transmission, but the actual TRANSMIT (or XMIT) command invokes user ID transmission request checking.
Specifies the FROM command or command to be executed at the transmitting end after successful completion of a system definition file transmission. Up to 40 characters are allowed (in quotation marks if there are embedded blanks). Any product command valid for entry from this source may be entered, including the EXEC and XMIT commands. Normal command authority checking applies.
Specifies the TO command or command to be executed at the receiving end after successful completion of a system definition file transmission. Up to 40 characters are allowed (in quotation marks if there are embedded blanks). Any product command valid for entry from this source can be entered, including the EXEC and XMIT commands. Normal command authority checking applies.
Provides the 1- to 8-character user group identifier for this request. This information is propagated with the file transmission request for the benefit of the data set access authorization exit (DSNCHECK) and is written to the log at the completion (successful or otherwise) of the transmission.
Specifies up to 40 characters (in quotation marks if embedded blanks are present) of user data that is associated with the request. This information is propagated with the file transmission request to the data set access authorization exit (DSNCHECK) and is written to the log at the completion (successful or otherwise) of the transmission.
Specifies the name of an existing definition that is to be chained for transmission from the current one after its successful completion. Normal privilege checking applies.
| Copyright © 2010 CA. All rights reserved. |
|