TSO COMMAND TRANSMIT TSO COMMAND TRANSMIT Author: TSO/E formatted on 1995/04/01 06:54 for assistance contact: SysTech Group information extracted from Help for TRANSMIT Other usages have be merged in to help you get what you need. -------------------------------------------------------------------------------- CLIST NAME. TRANSMIT users. Transmission of datasets and messages type. TSO command resides in SYS1.LINKLIB -------------------------------------------------------------------------------- TRANSMIT Transmit (XMIT) datasets and/or messages -------------------------------------------------------------------------------- related RECEIVE -------------------------------------------------------------------------------- +------------------------------------------------------------------------------+ | The material found herein was obtained and prepared for SCRIPT using the fol | | lowing clists: | | ===> @STRAPQ help transmit To obtain material (no further selection | | s were required) | | ===> @CAPSCR To make capital into boldface (NX lines | | only) | | ===> PLICHK script To make sure hp2 match ehp2 etc. | | ===> @SCRPTDU To create .du add cards and check spelli | | ng | | ===> FIXQUOTE To substitute open and closed quote tags | | ===> PERIOD Aid to help place two spaces after end o | | f sentence period. | | then do CHANGE '. ' '. ' nx followed by | | PFK-5/PFK-6. | | | | Comments have been added are shown in italics.. A new section entitled | | "Transmit files TSO to TSO -- Summary and Examples" has been added to the en | | d | | to show some specific examples. | | | +------------------------------------------------------------------------------+ The TSO/E Interactive Data Transmission Facility TRANSMIT command allows you to send data sets or messages to persons on other MVS systems via Network Job Entry or directly to persons on your own system. You may transmit sequential and partitioned data sets that have the fixed, vari- able and undefined record formats. You MAY NOT transmit ISAM and VSAM data sets, or data sets with user labels or keys. When you transmit a partitioned data set, the TRANSMIT command will invoke the IEBCOPY utility and then transmit the unloaded data set. The Interactive Data Transmission Facility RECEIVE command will restore the partitioned data set to its original format. You may also transmit a single member of a partitioned data set and request that it be transmitted as a sequential data set, thereby allowing the addressee to receive it either as a sequential data set or as a member of another partitioned data set. You may instruct the TRANSMIT command to append accompanying messages to the data set being transmitted by specifying the MESSAGE keyword. The messages that you enter will be shown to the addressee when the Interactive Data Transmission Facility RECEIVE command is issued. You may enter messages in full screen mode if you are logged on to a 3270 information display system terminal with a mini- mum screen size of 24 rows by 80 columns, or you may enter messages a line at a time. You may request that messages be entered in line mode on a 3270 terminal by specifying the LINE keyword. While entering message text in full screen mode, you may use the program function keys as follows PF7 or PF19 Scroll Up (beginning of data) PF8 or PF20 Scroll Down (end of data) PF3 or PF15 TRANSMIT data to addressee(s) PA1 Attention PA2 Reshow message text before last modification. You may invoke the TRANSMIT command in it simplest form by simply entering "TRANSMIT addressee-list". TRANSMIT will default to terminal input and you may now enter your message text. When the addressee invokes the Interactive Data Transmission Facility RECEIVE command, your message text will be displayed imme- diately without the addressee having to save and then list it. When you trans- mit messages in this manner, they will always be saved in the addressee's LOG and NOT in any other data set. (NOTE Use of the TRANSMIT MESSAGE keyword will inhibit this function.) You may request the TRANSMIT command to encipher your data before transmitting it by specifying the ENCIPHER keyword. You will then be prompted by the TRANS- MIT command for the enciphering options which will be passed to the Access Method Services REPRO command. The format of the TSO TRANSMIT command is TRANSMIT (or XMIT) (addresseelist) COPYLIST/NOCOPYLIST DATASET(dsn)/DSNAME(dsn)/DDNAME(ddname)/FILE(ddname)/ TERMINAL ENCIPHER EPILOG/NOEPILOG FULLSCREEN/LINE/LINE(nn) LOG/NOLOG/LOG(ALL) LOGNAME(name) MEMBERS(memberlist) MESSAGE/MSG NOTIFY/NOTIFY(ALL)/NONOTIFY OUTDDNAME(ddname)/OUTFILE(ddname)/ OUTDSNAME(dsname)/OUTDSN(dsname) PARM(parameters) PDS/SEQ PROLOG/NOPROLOG SYSOUT(sysout class or *) DEFAULTS EPILOG LOG NOCOPYLIST NOTIFY PDS PROLOG TERMINAL FULLSCREEN (display terminals only) 'addresseelist' You must specify at least this parameter to the TRANSMIT command. You may specify one or a combination of the following forms of addressees node/userid ===> POK/IBMUSER node.userid ===> POK.IBMUSER nickname ===> JPALMER distribution list ===> SANJOSE Enter HELP NICKNAME to obtain additional information on how to con- struct nickname and distribution list entries in the nickname section of the Interactive Data Transmission Facility names data set. DATASET Enter DATASET(dsname) to indicate to the TRANSMIT command the data set that you want transmitted to the specified addressee. DSNAME Enter DSNAME(dsname) to indicate to the TRANSMIT command the data set that you want transmitted to the specified addressee. DDNAME Enter DDNAME(filename) to indicate to the TRANSMIT command the filename of an already allocated data set that you want transmitted to the specified addressee. Typically this will be a data set which you have identified by issuing the TSO ALLOCATE command. FILE Enter FILE(filename) to indicate to the TRANSMIT command the filename of an already allocated data set that you want transmitted to the specified addressee. Typically this will be a data set which you have identified by issuing the TSO ALLOCATE command. TERMINAL You may request the TRANSMIT command to obtain its data to be trans- mitted from your terminal by specifying this keyword. Your input may be in line mode (LINE keyword) or in full screen (FULLSCREEN keyword). Your input will default FULLSCREEN mode if you are logged onto a 3270 Information Display System terminal with a minimum screen size of 24 rows by 80 columns. MESSAGE You may, in addition to transmitted a data set, append messages to your transmission by simply specifying the MESSAGE keyword. Your in- put may be in line mode (LINE keyword) or in full screen (FULLSCREEN keyword). Your input will default to FULLSCREEN mode if you are logged onto a 3270 Information Display System terminal with a minimum screen size of 24 rows by 80 columns. MSG You may, in addition to transmitted a data set, append messages to your transmission by simply specifying the MESSAGE keyword. Your in- put may be in line mode (LINE keyword) or in full screen (FULLSCREEN keyword). Your input will default to FULLSCREEN mode if you are logged onto a 3270 Information Display System terminal with a minimum screen size of 24 rows by 80 columns. COPYLIST You may request the TRANSMIT command to build a list of addressees and append it as a prolog to the message you are transmitting. If you are transmitting a data set, the list of addressees will be transmitted as an accompanying message. NOCOPYLIST You may request the TRANSMIT command not build and append a list of addressees with a transmission by specifying this keyword. This is the DEFAULT if you do not specify either keyword. ENCIPHER You may request the TRANSMIT command to encipher your data set prior to transmitting it to the addressee(s). If your installation allows this option the TRANSMIT command will prompt you for ENCIPHER options which will be passed to the Access Methods Services REPRO command. EPILOG You may request the TRANSMIT command to append epilog data from your names data set when a message is being transmitted. Enter HELP NICK- NAME to obtain additional information about how to construct the nicknames section of the Interactive Data Transmission Facility names data set. NOEPILOG You may request the TRANSMIT command not to append epilog data from your names data set when a message is being transmitted. This is the DEFAULT value if you do not specify either keyword. Enter HELP NICK- NAME to obtain additional information about how to construct the nicknames section of the Interactive Data Transmission Facility names data set. FULLSCREEN You may request the TRASNMIT command to obtain terminal input (MESSAGE keyword) in full screen mode by specifying the FULLSCREEN keyword. You may enter messages in full screen mode if you are logged on to a 3270 Information Display System terminal with a mini- mum screen size of 24 rows by 80 columns. While entering message text in full screen mode, you may use the program function keys as follows PF7 or PF19 Scroll Up (beginning of data) PF8 or PF20 Scroll Down (end of data) PF3 or PF15 TRANSMIT data to addressee(s) PA1 Attention PA2 Reshow message text before last modification. LINE You may request the TRANSMIT command to obtain LINE(nn) data from the terminal a line at a time by specifying the LINE keyword. Your terminal input will default to this mode if you are not logged on to a 3270 Information Display System terminal with a minimum screen size of 24 rows by 80 columns. You may also use the LINE keyword when entering data while executing a CLIST. You may ter- minate LINE mode input by either entering a null line or the one or two character value entered on the LINE(xx) format of the LINE keyword. LOG You may request the TRANSMIT command to log all transmissions by specifying the LOG keyword. Your entry in the log data set will con- tain the following information node, userid, data set name and the date transmitted. NOTE When you specify the LOG keyword, it will override any LOG function specified on nickname or distribution list entries found in the TRANSMIT names data set which are involved in this transmission. Enter HELP NICKNAME to obtain additional informa- tion on how to construct the nicknames section of the Interactive Data Transmission Facility names data set. NOLOG You may request the TRANSMIT command not to log transmissions by specifying the NOLOG keyword. NOTE When you specify the NOLOG keyword, it will override any LOG function specified on nickname or distribution list entries found in the names dataset which are in- volved in this transmission. Enter HELP NICKNAME to obtain addi- tional information on how to construct the nicknames section of the Interactive Data Transmission Facility names data set. LOG(ALL) You may request the TRANSMIT command to build a log entry for each addressee in an addressee list and for any addressees obtained from distribution lists in the names data set. NOTE When you specify the LOG(ALL) keyword, it will override any LOG function specified on nickname or distribution list entries found in the names dataset that are involved in this transmission. Enter HELP NICKNAME to obtain ad- ditional information on how to construct the nicknames section of the Interactive Data Transmission Facility names data set. LOGNAME You may request the TRANSMIT command to log a transmission in a par- ticular log data set by specifying LOGNAME(logname) keyword. Your transmission will then be logged in the data set named 'userid.log.logname'. NOTE When you specify the LOGNAME keyword, it will override any LOG function specified on nickname or distribution list entries found in the names dataset that are involved in this transmission. Enter HELP NICKNAME to obtain additional information on how to construct the nicknames section of the Interactive Data Transmission Facility names data set. MEMBERS You may request the TRANSMIT command to process selected members of a partitioned data set by specifying the MEMBERS keyword. You may specify MEMBERS(member01) to transmit a single member or you may specify MEMBERS(member01 member02 etc) to transmit a list of members. NOTIFY You may request the TRANSMIT command to indicate to the Interactive Data Transmisison Facility RECEIVE command that RECEIVE should trans- mit a notification to you when the addressee has received the data sent by you. Your NOTIFY request will always occur when you use the node.userid and node/userid addressee format. For nicknames and dis- tribution lists, your notification requests are controlled by the :NOTIFY/:NONOTIFY tag in the names data set. NOTE When you specify the NOTIFY keyword, it will override any NONOTIFY function specified on nickname or distribution list entries found in the names dataset which are involved in this transmission. Enter HELP NICKNAME to obtain additional information on how to con- struct the nicknames section of the Interactive Data Transmission Fa- cility names data set. NOTIFY(ALL) You may request the TRANSMIT command to indicate to the Interac- tive Data Transmisison Facility RECEIVE command that RECEIVE should transmit a notification to you when the addressee has received the data sent by you. Your NOTIFY request will always occur when you use the node.userid and node/userid addressee format. For nicknames and distribution lists, your notification requests are controlled by the :NOTIFY/:NONOTIFY tag in the names data set. NOTE When you specify the NOTIFY(ALL) keyword, it will override any NONOTIFY function specified on nicknames or distribution list entries found in the names dataset which are involved in this transmission Enter HELP NICKNAME to obtain additional information on how to con- struct the nicknames section of the Interactive Data Transmission Fa- cility names data set. NONOTIFY You may request the TRANSMIT command to suppress notification when a file has been received by an addressee by specifying the NONOTIFY keyword. Please note that when you specify the NONOTIFY keyword that it completely suppresses the notification process including any :NO- TIFY specifications on nickname and distribution list entries in your names data set. -------------------------------------------------------------------------------- TSOMODEL.PUBLIC.TEXT(INDEX) 1995/04/01 06:54 Author: SYSTECH Group for assistance contact: SysTECH Group Page STATUS-2. SYSTECH NOTICE -- CLISTS NOTE When you specify the NONOTIFY keyword, it will override any NOTIFY func- tion specified on nickname or distribution list entries found in the names dataset that are involved in this transmission. Enter HELP NICKNAME to obtain additional information on how to construct the nicknames section of the Interactive Data Transmission Facility names data set. OUTDDNAME You may request the TRANSMIT command to direct its output into a file allocated during your TSO session rather than to the Job Entry Subsystem (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility RECEIVE command INDA- TASET/INDSNAME/ INFILE/INDDNAME keywords. It will be generally used by your installation support personnel. -- OUTDDNAME is not of any practical use; it is restricted to local system use only. NOTE The data set attributes of the data set associated with the OUTDDNAME allocation will be LRECL=80 BLKSIZE=3120 RECFM=FB. OUTFILE You may request the TRANSMIT command to direct its output into a file allocated during your TSO session rather than to the Job Entry Sub- system (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility RECEIVE command INDATASET/INDSNAME/ INFILE/INDDNAME keywords. It will be generally used by your installation support personnel. -- INFILE is not of any practical use; it is restricted to local system use only. NOTE The data set attributes of the data set associated with the OUTDDNAME allocation will be LRECL=80 BLKSIZE=3120 RECFM=FB. OUTDATASET You may request the TRANSMIT command to direct its output into a file allocated during your TSO session rather than to the Job Entry Subsystem (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility RECEIVE command INDA- TASET/INDSNAME/ INFILE/INDDNAME keywords. It will be generally used by your installation support personnel. -- OUTDDNAME is not of any practical use; it is restricted to local system use only. NOTE The data set attributes of the data set associated with the OUTDDNAME allocation will be LRECL=80 BLKSIZE=3120 RECFM=FB. OUTDSNAME You may request the TRANSMIT command to direct its output into a file allocated during your TSO session rather than to the Job Entry Subsystem (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility RECEIVE command INDA- TASET/INDSNAME/ INFILE/INDDNAME keywords. It will be generally used by your installation support personnel. -- OUTDDNAME is not of any practical use; it is restricted to local system use only. NOTE The data set attributes of the data set associated with the OUTDDNAME al- location will be LRECL=80 BLKSIZE=3120 RECFM=FB. PARM You may specify a character string to be passed to your installa- tion's exit routines. If the parameter contains blanks or other spe- cial characters, you must enclose the string in quotes. Normally, you will only supply a parameter value if indicated by your installa- tion support personnel. This parameter value only has meaning to your installation's exit routines. PDS You may request the TRANSMIT command to preserve the directory infor- mation of the partitioned data set you are transmitting by specifying this parameter. When you specify the PDS keyword you will force the addressee to restore the transmitted file as a partitioned data set. SEQ You may request the TRANSMIT command not to preserve the directory information, but rather to transmit the partitioned data set as a se- quential data set. This allows the addressee to receive the file as a sequential data set or as a member of a partitioned data set. You may only specify SEQ when you specify a single member of a parti- tioned data set. PROLOG You may request the TRANSMIT command to prefix prolog data from the control section of your Interactive Data Transmission Facility names dataset by specifying the PROLOG keyword. Enter HELP NICKNAME to ob- tain additional information on how to construct the control section of your Interactive Data Transmission Facility names data set. NOPROLOG You may request the TRANSMIT command NOT to prefix prolog data from the control section of your Interactive Data Transmission Facility names dataset by specifying the PROLOG keyword. Enter HELP NICKNAME to obtain additional information on how to construct the control sec- tion of your Interactive Data Transmission Facility names data set. SYSOUT You may request the TRANSMIT command to direct utility program mes- sages (e.g. IEBCOPY) to a specific sysout class or to your terminal. If you specify SYSOUT(*), you will receive all utility program mes- sages on your terminal. Transmit files TSO to TSO -- Summary and Examples A list of valid nodes can be found in "TSOMODEL.PUBLIC.TEXT(DEST)". The TSO/E interactive data transmission facility TRANSMIT command allows you send datasets or messages to persons on other MVS systems via network job entry or directly to a person on your own system. The TSO/E interactive data transmission facility RECEIVE command allows you to obtain files transmitted to your userid. The RECEIVE command will prompt you for additional parameters after obtaining a file from JES. If you do not specify any parameters, they will be defaulted or obtained from the control records transmitted with the data. For more informa- tion on the "RECEIVE" TSO command please read the HELP screens or @SCRIPT the member "IS03.SHARE.TEXT(RECEIVE)". Examples: Transmit from AHCENTER to FIBERS and RECEIVE at FIBERS Logged on at Mytown type in the TSO command TRANSMIT FIBERS.userid DSNAME('userid.dsnode2.dsnode3(member)') NONOTIFY resulting messages IEBCOPY MESSAGES AND CONTROL STATEMENTS COPY OUTDD=sys00081,INDD=((sys00075,R)) SELECT MEMBER=(RECEIVE) IEB167I FOLLOWING MEMBER(S) UNLOADED FROM INPUT DATA SET REF- ERENCED BY sys00075 -ÿ IEB154I member HAS BEEN SUCCESSFULLY UNLOADED INMX000I 0 MESSAGE AND 6 DATA RECORDS SENT AS 214 RECORDS TO fibers.userid -- or if SEQ added then a sequential dataset will be transmit- ted-- INMX000I 0 MESSAGE AND 351 DATA RECORDS SENT AS 194 RECORDS TO fibers.userid Afterwards logged on at FIBERS type in the TSO command as shown. Receiving da- taset must exist or additional parameters would be required on the RECEIVE. RECEIVE when prompted to enter restore parameters type in the word DSNAME then hit enter when prompted to enter dataset name type in the dataset name 'userid.dsnode2.dsnode3' (quotes required unless using your own PREFIX). Enter as follows: ===> TSO RECEIVE da('userid.dsnode2.dsnode3') Example of sending only a message: Transmit from user1 to user2 at node N1 (Mytown) TRANSMIT N1.user2 Supply message when prompted -- hit PFK-3 to indicate completion. Notify user -- if you are logged onto the same system SEND 'Please enter TSO RECEIVE to receive message',u(user2),l EDIT---- TECH.INFO.TEXT(DALLAS) - 01.00 - COLUMNS 001 12 4 COMMAND ===> @TSOXD SCROLL ===> CS R ****** ************************ TOP OF DATA ***************************** 000010 PROC 0 000020 /* -----------------------------------------. 000030 /* CHANGE DATA, TO EXECUTE USE ==> @TSOXD 000040 /* -----------------------------------------. 000050 /* 000060 /* TRANSMISSION FROM Mytown TO DALLAS 000070 /* AT DALLAS DATASETS ARE RECEIVED AS 000080 /* ==> TSO RECEIVE 000090 /* DA(DALLAS.TEXT(XXXXXXXX)) 000100 /* DA(DALLAS.TEXT(YYYYYYYY)) 000110 /* TRANSMIT CCC.BWDFM MSG 000120 /* TRANSMIT CCC.BWDFM DSNAME('IS01.LIBR.TEXT(PORTFOLO)') SEQ 000130 /* TRANSMIT CCC.BWDFM DSNAME('TECH.INFO.TEXT(SOFTWARE)') SEQ 000140 /* TRANSMIT N14.BWDFM DSNAME('TECH.LIBR.TEXT(INSTALL)') SEQ 000150 /* TRANSMIT CCC.BWDFM DSNAME('SYS1.TSOCLIST(@TSOXD)') SEQ 000160 /* TRANSMIT CCC.BWDFM DSNAME('SYS1.TSOCLIST(@TSO)') SEQ 000170 TRANSMIT CCC.BWDFM DSNAME('TECH.INFO.TEXT(DALLAS)') SEQ ****** ************************* BOTTOM OF DATA ***************************** From Mytown to Dallas use CCC.userid or N14.userid From Dallas to Mytown use AHCENTER.userid -------------------------------------------------------------------------------- TRANSMIT and RECEIVE logs Profs note from D.McRitchie 1990/08/28 There is a log kept of your transmissions, where a record is kept of the file transmitted and the file received showing the complete dataset name and node or userid at each end. on TSO -- userid.LOG.TRANSMIT on VM -- vmuserid NETLOG A If your space utilization gets high on VM, you may wish to ERASE the your NETLOG so that it will start over. With automatic archive/RESTORE you may want to do the same under TSO in the future.