Home

TCP/IP Application Services (TAS) File Transfer User Guide

1. Getting File Registration Status FSTATUS Command _ 0 000 e eee Beginning a Session LOGIN Command Closing a Session LOGOUT Command Creating a Directory on a Remote Host MKD Command _ 0 0 0 0 eee Printing the Current Directory on a Remote Host PWD Command _ Removing a Directory on a Remote Host RMD Command _ 0 0 Renaming a File RENAME Command Restarting a File Transfer RESUME Command Restarting a File Transfer within a Local Host Restarting a File Transfer Local to Remote Restarting a File Transfer Remote to Local Restarting a File Transfer between Remote Hosts Specifying a Restart Point for a File Transfer RECOVENY ssa dep gS eee ite ears senate Transferring a File TRANSFER Command Transferring a File or Element within a Local Host Transferring a File or Element Local to Remote Transferring a File or Element Remote to Local Transferring a File or Element between Remote TOSES Sete reraney sei es a hater tity A ee vil 5 2 5 4 5 6 l 5 8 5 10 5 11 5 12 3 5 13 l 5 13 5 15 5 16 l 5 16 5 17 5 19 5 20 5 24 5 26 5 28 5 30 5 31 5 33 5 35 5 37 5 39 5 40 l 5 41 5 42 5 42 5 43 5 46 5 55 5 56 5 56 5 57 Contents 5 20 5 Including More Specific Information about a File Transiter iorra a a E ed Mo
2. Siteinfo Accept Data lt gt Sooo o Example 3 16 Transferring a File Using the PUT Screen 3787 3213 301 Registering a File for Event Notification REGISTER Screen 3 14 Registering a File for Event Notification REGISTER Screen How Register Works When you issue a Register command the file name you enter with the command is converted into a file id TAS then checks the list of previously registered file ids This check determines if there already is a registered file id that exactly matches the file id that you want to register In this comparison a wild card indicator is treated as a normal character Thus wild card indicators must match corresponding wild card indicators for the file ids to match If TAS finds a match with a previously registered file name the command is rejected otherwise the new file name is included in the list of registered files You must provide at least a qualifier and filename when registering a file Use the REGISTER screen to register a filename for event notification When a file is registered TAS starts a user defined runstream when the registered filename is received at its destination You can register a single filename or a range of filenames You can specify a range of filenames with the wild card character You can specify start options for the runstream You can specify whether to start or add the runstream You can specify that the filename be deregistered
3. 3787 3213 301 Bibliography 1
4. Continue to enter a question mark and transmit to display the additional messages When you reach the end of the message series you receive the following message This completes the message series Type a to repeat the series Accessing Parameter Help To access help for a parameter 1 Enter the name of the command and the parameter followed by a question mark 2 Transmit the command Example 4 10 shows how to access help for the FILE parameter C gt DEALLOCATE FILE Keyword parameter FILE specifies the file you want to delete This is the first positional notational parameter gt C gt Example 4 10 Accessing Help for a Parameter In some cases there may be more help available through additional messages To receive any additional help messages 1 Enter a question mark next to the start of entry symbol 2 Transmit the command gt C gt Continue to enter a question mark and transmit to display the additional messages When you reach the end of the message series you receive the following message This completes the message series Type a to repeat the series Accessing Error Message Help To receive an explanation of an error message you receive 1 Enter a question mark next to the start of entry symbol 2 Transmit the command 3787 3213 301 4 11 Using On Line Help for Commands Example 4 11 shows how to access help for an error message O gt
5. 3 84 3787 3213 301 Transferring a File TRANSFER Screen 10 11 12 13 14 15 Enter the identifier of the source host in the Source Host field Enter the sending file name or file name and element name in the Source File Name field Enter the identifier of the destination host in the Destination Host field Enter the receiving file name or file name and element name in the Destination File Name field Enter a user id in the source 1 Userid field if your local user id is not appropriate for the source host Enter a user id in the destination 2 Userid field if your local user id is not valid for the destination host Enter a password in the source 1 Password field Enter a password in the destination 2 Password field Enter an account number in the source 1 Account field if your local account information is not valid for the source host Enter an account number in the destination 2 Account field if your local account information is not valid for the destination host Enter a project identifier in the Source Project field if you do not want to use the default Enter a project identifier in the Dest Project field if you do not want to use the default If you want to include additional file transfer information for example defining the file type see Including More Specific Information About a File Transfer later in this section Transmit the screen The file transfer facilit
6. This is useful when the data portion of the file or element is usable on the other host TAS uses ERIOWS to access the file or element This type is not supported for transfers between OS 2200 hosts Max Record Size Indicates the largest number of bytes to be passed as a message to DDP PPC when the Structure field is specified as Record The default value 3968 bytes is strongly recommended Use 1 to 5 digits The maximum value is 7168 bytes The default is 3968 bytes continued 3787 3213 301 3 75 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont ee Translate Subfield Description Transparent Use Transparent when the data type is something other than ASCII or EBCDIC Use for binary floating point or control characters Use this option when you transfer an entire program file TAS performs no translation in the transmission file The default is e Transparent when you transfer an entire program file or SDF file e Ascii when you transfer a symbolic element ASCII is the most efficient data type between OS 2200 hosts The default is e Ascii when you transfer a symbolic element e Transparent when you transfer an entire program file or SDF file Ebcdic Translates the file to 8 bit EBCDIC code during the transfer L36 Use this option to alert a remote host that the local byte size of the transferred binary data is 36 bits L36 is only meaningful to a remote hos
7. 3 11 3 12 3 13 3 14 3 15 3 16 3 17 3 18 3 19 3 20 3 21 3 22 3 23 3 24 3 25 3787 3213 301 Accessing the TAS FTPMSG Error Messages File Clearing a Terminal Broadcast or Terminal Message Accessing a Command Screen using a Command Code Accessing a Command Screen Using the Cursor ww se ee ee Accessing a Command Screen from Another Command Screen Accessing General Help from the Main Menu 00 Accessing Command Help oe eee GommandHelp Sereen rarua ese cn e A ee Accessing Field Help oo nannaa Field Help Response ooon nannaa Accessing Error Message Help ww ene Reserving Storage on a Remote Host for the Transferred File Changing to the Parent Directory 0 0 00000 cc cece eee Changing the Working Directory ona Remote Host Deleting a File on a Local Host Using the DEALLOCATE Screen Deleting a File on a Remote Host Using the DEALLOCATE Screen Deregistering All FilenamesAssocaited with an Applicationid Listing Available Functions for a Local Host Using the FHELP Screen Response to Listing Available Functions on a Local Host Using the FHELP CHOON aana ty as ate sn tel a Std ibaa taal eink enema ek ay as Listing Available Functions on a Remote Host Using the FHELP Screen Response to Listing Available Functions on a Remote Host Using the FHELP oE a facG hs A omn
8. HOST hostid The identifier of the host Use 1 to 132 alphanumeric characters For more information about specifying host ids see Section 1 PASSWORD remote password The password as required by the remote host Use 1 to 18 alphanumeric characters CLEARANCE_LEVEL remote clearance level The clearance level of the remote host Enter a number between 0 and 64 USERID remote user id The user identifier as required by the remote host Use 1 to 12 alphanumeric characters continued 5 28 3787 3213 301 Beginning a Session LOGIN Command Table 5 10 LOGIN Command Keyword Parameter Descriptions cont ACCOUNT remote account info For an OS 2200 host the account information includes the account number followed by the project id Use 1 to 25 alphanumeric characters When you include a space enclose the account information in double quotes 3787 3213 301 5 29 Closing a Session LOGOUT Command 5 14 Closing a Session LOGOUT Command Use the LOGOUT command to end a session between two hosts Command Format LOGOUT Use the LOGIN command when you want to open a new session While a session is open FPUT and FGET commands move files between hosts You can also open a session by specifying a host id on other FTP commands Refer to Methods of Transferring Files in 1 3 for more information about sessions Note When you issue this command the session remains open See the subsection called
9. The registered files associated with application id BBG are File 1 abc def Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character A AA BCDHH CCE File 2 uopt abc ggh Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character UOPT ABC GGH File 3 uopt abc ggh wild card g Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character UOPT ABC 33H The file id generated from the Deregister command filename is Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character A AA BCDHH CCE The result is Only File 2 under application id BBG is removed 3787 3213 301 3 19 Deregistering a File DREGISTER Screen ES FTP 6R1 DREGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID BBG File name opt abc ggh Wild Card Character __ De Register All yes NO Accept Data lt gt FTP5095 Command completed successfully z 3 6 3 Deregistering FilenamesThat Match a Specified File Name Procedure To deregist
10. 3 Inthe From file password field enter the password you specified for the source file on the TRANSFER or GET command screen 4 Inthe To file password field enter the password you specified for the destination file on the TRANSFER screen 3787 3213 301 Restarting a File Transfer RESUME Screen 5 If you want to specify where to restart a file transfer see Specifying a Restart Point for a File Transfer Recovery later in this section 6 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 14 for additional information about field values Example Example 3 24 illustrates restarting a file transfer from a remote host to a local host OO SO er eh FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name CHK At checkpoint id From file password SNS Clearance Level _ To file password ord Clearance Level _ Accept Data lt gt FTP5095 Command completed successfully NY Example 3 24 Restarting a File Transfer from a Remote Host to a Local Host Using the RESUME Screen 3 17 4 Restarting a File Transfer between Remote Hosts Procedure To restart a file transfer between remote hosts 1 Display the RESUME screen from the Main Menu or from any other command screen 2 Inthe Checkpoint file name field enter the name of the checkp
11. 3 12 Printing the Current Directory on a Remote Host PRINT WORKING DIRECTORY Screen Function Use the PRINT WORKING DIRECTORY screen to display the name of the current working directory for this user The name of the current directory and a completion message display at the bottom of this screen If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 11 shows the PRINT WORKING DIRECTORY screen Oe eee sts FTP 6R1 PRINT WORKING DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host ee ee Userid Password Account Accept Data lt gt rs Figure 3 11 PRINT WORKING DIRECTORY Screen Screen Field Descriptions Table 3 10 describes the fields in the PRINT WORKING DIRECTORY screen 3787 3213 301 3 41 Printing the Current Directory on a Remote Host PRINT WORKING DIRECTORYScreen Table 3 10 PRINT WORKING DIRECTORY Screen Fields es The name of the remote host where the current working directory is located Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required if a session is not currently active For more information about specifying host ids see Section 1
12. C gt TRANSFER FROM 26 3 0 3 OLDFIL ELEMENT TO NEWFIL ELEMENT C gt PASSWORD SNS TYPE ALL FTP835 You entered conflicting values for the FROM and TYPE parameters of the TRANSFER command gt gt gt If you specify an element to be transferred on the FROM you must use gt the TYPE parameter The value of the TYPE parameter may not be ALL gt C gt Example 4 11 Accessing Help for an Error Message In some cases there may be more help available through additional messages To receive any additional help messages 1 Enter a question mark next to the start of entry symbol 2 Transmit the command gt C gt Continue to enter a question mark and transmit to display the additional messages When you reach the end of the message series you receive the following message This completes the message series Type a to repeat the series 4 12 3787 3213 301 Section 5 Using the Command Interface 5 1 File Transfer Commands The following commands are covered in this section in alphabetical order e ALLOCATE e CDUP e CWD e DEALLOCATE e DREGISTER e FGET e FHELP e FPUT e FREGISTER e FSITE e FSTATUS e LOGIN e LOGOUT e MKD e PWD e RMD e RENAME e RESUME e TRANSFER 3787 3213 301 5 1 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Command 5 2 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Command Use the
13. REA ANcE LEVEL remote clearance level USERID remote user id ACCOUNT remote account info DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info 3787 3213 301 Using the Command Interface RENAME RESUME TRANSFER 3787 3213 301 HOST host id 1 FROM old file name 2 TO new file name 3 PASSWORD remote password USERID remote user id ACCOUNT remote account info FILE file name 1 AT checkpoint id 2 PASSWORD remote password 1 remote password 2 3 CLEARANCE LEVEL remote clearance level 1 remote cl arance level 2 FROM host id 1 file name 1 element name 1 1 T0 host id 2 file name 2 element name 2 2 PASSWORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 ERE ARANCE LEVEL clearance level i ACCOUNT Temote account info 1 remo e account info 2 TYPE SYMBOLIC ALL OMNIBUS SDF SOURCE TOM TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POSITION REPLACE ADD CHECKPOINT file name 3 ARK 250 integer SITEINFO information Using On Line Help for Commands 4
14. Using the Header Section The header section displays the e Product name and release number e Name of the command e Current date in YY MM DD format 3787 3213 301 Using the Menu Interface Using the Function Key Section You make general requests such as Help and Refresh from the function key section To issue a request either e Press the appropriate function key e Move the cursor between the angle brackets following the desired function and transmit Table 2 1 summarizes the requests available in the function key section Table 2 1 Function Key Section Requests Function Key Transmit Poston fmen Displays help information for the current screen F2 Refresh lt gt Redisplays the screen from the point of the last transmit When you enter data in a screen and press F2 before you transmit the screen is redisplayed blank When you enter data and press F2 after a transmit the screen is redisplayed with the data you entered Command _ lt gt Displays the command screen you specify To select this function type the two letter command code and transmit Note You can use the F2 function key or Refresh field to clear a terminal message or terminal broadcast you receive during a file transfer session Example 2 1 shows how to use the Refresh field to clear a broadcast message from a TRANSFER screen you were using to enter data 2 4 3787 3213 301 Using the Menu Interface OS FTP 6R1 T
15. i ACCOUNT Temot e account info 1 remote account info 2 TYPE SYMBOLIC ALL OMNIBUS Sor souRce Tow TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POSITION REPLACE ADD CHECKPOINT file name 3 ARK 250 integer SITEINFO information You can omit the keywords portions FROM TO and PASSWORDz when you use positional notation Include the parameter values in this order Keyword Parameters Table 5 16 describes the keyword parameters for the TRANSFER command For additional help using TYPE TRANSLATE and STRUCTURE see Table 5 17 Table 5 16 TRANSFER Command Keyword Parameter Descriptions FROM host id The host id is the name of the host where the file resides Use 1 to 24 alphanumeric characters If you omit the host identifier the local host is used For more information about specifying host ids see Section 1 continued 3787 3213 301 5 47 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont FROM continued filename 1 Use file name 1 and element name 1 to element name specify the name of the file and element you want to transfer You must specify a file name This must be a valid file name for the system on which the file resides For more information about specifying host ids see Section 1 The host id is the name of the host to which you a
16. 4 10 4 3 1 Types of Help Available 0 4 10 4 3 2 Accessing Command Help 4 10 4 3 3 Accessing Parameter Help 0 eee 4 11 4 3 4 Accessing Error Message Help 4 11 Section 5 Using the Command Interface 5 1 File Transfer Commands_ 5 1 vi 3787 3213 301 Contents 3787 3213 301 5 2 5 3 5 4 5 5 5 5 1 5 5 2 5 6 5 6 1 5 6 2 5 7 5 8 5 8 1 5 8 2 5 9 5 10 5 11 5 12 5 13 5 14 5 15 5 16 5 17 5 18 5 19 5 19 1 5 19 2 5 19 3 5 19 4 5 19 5 5 20 5 20 1 5 20 2 5 20 3 5 20 4 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Command Changing to the Parent Directory CDUP Command aa Changing the Working Directory on a Remote Host CWD Command aoaaa Deleting a File DEALLOCATE Command Deleting a File on a Local Host Deleting a File on a Remote Host Deregistering a Filename DREGISTER Command Deregistering a Single Filename Deregistering All Filenames Getting a File during a Session FGET command Getting Help FHELP Command Listing Available Functions on a Local Host Listing Available Functions on a Remote Host Sending a File During a Session FPUT Command Registering a Filename FREGISTER Command Transferring Information Requested by a Foreign Host FSITE Command
17. Deregistering All File Names Associated with an ApplicatonID 2 eee Deregistering FilenamesThat Have No Associated Wildcard lt tc ove 4 cus tick eae iota 2 1 2 1 2 2 2 2 2 3 2 3 2 3 2 4 2 5 2 7 2 7 2 7 2 9 2 9 2 10 2 10 2 10 2 11 2 12 2 14 3 1 3 2 3 5 3 8 3 11 3 12 3 13 3 15 3 16 3 18 3787 3213 301 Contents 3787 3213 301 3 6 3 3 6 4 3 7 3 7 1 3 7 2 3 8 3 9 3 10 3 12 3 13 3 14 3 14 1 3 14 2 3 14 3 3 14 4 3 14 5 3 14 6 3 15 3 16 3 17 3 17 1 3 17 2 3 17 3 3 17 4 3 17 5 3 18 3 19 3 19 1 3 19 2 3 19 3 Deregistering FilenamesThat Match a Specified File Namie Aiton a E Or E a EN raea Deregistering FilenamesThat Were REgistered With Wildcard askean a e a Getting Help FHELP Screen Listing Available Functions on a Local Host Listing Available Functions on a Remote Host Transferring Information Requested by a Foreign Host FSITE Screen Requesting a File During a Session GET Screen Opening a Session with a Remote Host LOGIN SCIE N ese ieee ch Gites So Eea ben ca ant Making a Directory on a Remote Host MAKE DIRECTORY Screen Printing the Current Directory on a Remote Host PRINT WORKING DIRECTORY Screen Sending a File During a Session PUT Screen Registering a File for Event Notification REGISTER Ser n sce hee i eee Converti
18. Ending under 4 1 for information on how to close a session 5 30 3787 3213 301 Creating a Directory on a Remote Host MKD Command 5 15 Creating a Directory on a Remote Host MKD Command Use the MKD command to create a directory or subdirectory on a remote foreign host If you specify a host id any existing session is closed and a new session is opened with the specified host Command Format MKD DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info Keyword Parameters Table 5 11 describes the keyword parameters for the MKD command Table 5 11 MKD Command Keyword Parameter Descriptions DIRECTORY remote pathname The name of the directory or subdirectory you want to create on the remote host Use 1 to 132 alphanumeric characters This parameter is required HOST hostid The identifier of the host where you want to create a directory or subdirectory Use 1 to 255 alphanumeric characters If you omit the hostid the host to which you are currently logged in is used Specify a host id if a session is not currently active or if you want to close the current session and open a session with another host For more information about specifying host ids see Section 1 USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters PASSWORD remote password he password as required by the foreign host Use
19. INITIATE initiate Indicates how to execute the runstream Add using an ADD ECL statement A response is not returned to the initiator of the command until the runstream completes Start using an START ECL statement A response is returned to the initiator of the command as soon as the START is issued Examples Example 5 10 shows how to register a single filename gt C gt FREG USERID ftpuser FILE QUAL FILENAME X RUN QUAL RUN ELEMENT gt END COMMAND Example 5 10 Registering a Filename Example 5 11 shows how to register a filenamewith a wild card Example 5 11 Registering Multiple Filenames cont 5 22 3787 3213 301 Registering a Filename FREGISTER Command gt C gt FREG USERID ftpuser FILE QUAL FILEX RUN QUAL RUN ELEMENT amp gt C amp PWILD X gt END COMMAND Example 5 11 Registering Multiple Filenames Note See Section 3 14 for more information about registration 3787 3213 301 5 23 Transferring Information Requested by a Foreign Host FSITE Command 5 11 5 24 Transferring Information Requested by a Foreign Host FSITE Command Use the FSITE command to send protocol not supported by the TAS commands These protocols may only be sent to remote non OS 2200 hosts This command actually functions like a QUOTE command whatever information you provide is sent to the remote host However TAS does not allow all protocols to be sent Note that you can also include FS
20. RESUME Command Table 5 15 RESUME Command Keyword Parameter Descriptions cont AT checkpoint id The identifier of a checkpoint marker listed in the checkpoint file Indicates where you want the transfer to resume When you omit the checkpoint id the file transfer resumes at the last checkpointid listed in the checkpoint file For more information about checkpointing see Section 1 PASSWORD remote password 1 The password you specified for remote password 1 of the password parameter in the TRANSFER or FGET command when you transferred the file This field is required when the file resides on either a e Remote host e Local host and the file has read write keys Use 1 to 18 alphanumeric characters remote password 2 The password you specified for remote password 2 of the password parameter in the TRANSFER or FPUT command when you transferred the file This field is required when the file resides on either a e Remote host e Local host and the file has read write keys Use 1 to 18 alphanumeric characters CLEARANCE_LEVEL remote clearance level 1 The clearance level for the file being sent Enter a number between 0 and 64 remote clearance level 2 The clearance level for the file being received Enter a number between 0 and 64 5 19 1 Restarting a File Transfer within a Local Host 5 40 3787 3213 301 Restarting a File Transfer RESUME Command Function Use this format to
21. e RENAME These commands do not require a remote host id if a session is in progress If a session is not already established you can open a session without a LOGIN command by providing a remote host id with the command With the exception of the FHELP command the session remains open after the command is executed If a session is in progress and you supply a remote host id the current session is closed and a new session is opened to the host you specify even if it is the same host Note Closing the current open session and opening a new session involves a large amount of overhead processing This overhead is incurred even when you specify the same host as in the current session Error Messages TAS provides error messages when file transfer problems are encountered Each message contains e A description of the problem e A recommended corrective action Error messages are handled in three different ways 3787 3213 301 1 11 What Do I Need to Know to Use File Transfer 1 3 5 1 12 P O Displayed on line Occurs when you invoke the file transfer facility on your local host using the menu or command interface For information about getting on line help for error messages see 2 3 and 4 3 Stored in a file on your host called TAS FTPMSG Occurs when a user on a remote host invokes the file transfer facility on your local host Each message in the TAS FTPMSG file has a time and date stamp To read the error
22. e Sign off procedure in use at your site 2 1 1 Starting File Transfer To begin file transfer 1 Log on to the local host using your site specific procedure 2 Type FTP 3 Transmit the command When you start your session the file transfer facility displays the MAIN MENU C TTT y FTP 6R1 FILE TRANSFER PROTOCOL 97 08 30 MAIN MENU Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt Move the cursor to the desired command and transmit or Type the desired command code and transmit File Transfer lt gt tr Transfer lt gt lo Login lt gt al Allocate lt gt re Resume lt gt ge Get lt gt cp Change to Parent lt gt de Deallocate lt gt pu Put lt gt cd Change Work Dir lt gt rn Rename lt gt cl Close lt gt md Make Dir lt gt fs Fsite lt gt rf Register lt gt pw Print Work Dir lt gt fh Fhelp lt gt dr De register lt gt rd Remove Dir lt gt sr Status Request so From the MAIN MENU you can e Access any file transfer command screen e Access a series of help screens describing the file transfer functions 3787 3213 301 2 1 Starting and Ending a Menu Interface Session 2 1 2 2 1 3 2 2 e Close a session between two hosts Starting and Ending a Session A session between two hosts is an open connection Files can be transferred back and forth across this connection Sessions are opened by using the LOGIN screen or by entering a remote host
23. gt END COMMAND Example 5 4 Deleting a File on a Local Host Using the DEALLOCATE Command 5 5 2 Deleting a File on a Remote Host Function Use this format to delete a file on a remote host Format DEALLOCATE FILE host id file name 1 PASSWORD remote password 2 USERID remote user id Ee ARANCE LEVEL remote clearance level ACCOUNT remote account info See Table 5 4 for information about parameter values Example Example 5 5 shows how to delete the file NYCFILE from a remote host In this example we omit the keyword FILE because we are using positional notation We specify a remote e Host id SD 01 e Password SNS e User id SITJFB e Account information ST 103 COMMS gt C gt DEAL SD 01 NYCFILE PASS SNS USER SITFJB ACCO ST 103 COMMS gt END COMMAND Example 5 5 Deleting a File on a Remote Host Using the DEALLOCATE Command 3787 3213 301 5 11 Deregistering a Filename DREGISTER Command 5 6 Deregistering a Filename DREGISTER Command Use the DREGISTER command to deregister a filename for event notification When a filename is deregistered TAS no larger starts a user defined runstream when that file is received You can deregister a single filename or all the filenames for an application Command Format DREGISTER USERID application id FILE file name WILD wi1d card character DREG ALL YES NO Keyword Parameters Table 5 5 describes the keyword parameters for the
24. lt gt Application ID ftpappl Filename Qual Filewest Runstream Start File Element Start Options Control Value Wild Card Character _ One Time Registration yes X NO Save Filename and Status yes X NO __ Initiate add __ START _ Accept Data lt gt FTP5095 Command completed successfully es SSS Example 3 19 Registering Using One Time Registration and Save Status 3 54 3787 3213 301 Removing a Directory on a Remote Host REMOVE DIRECTORY Screen 3 15 Removing a Directory on a Remote Host REMOVE DIRECTORY Screen Function Use the REMOVE DIRECTORY screen to remove a directory on a remote foreign host If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 14 shows the REMOVE DIRECTORY screen ers FTP 6R1 REMOVE DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Directory Userid Password Account Accept Data lt gt E Figure 3 14 REMOVE DIRECTORY Screen Screen Field Descriptions Table 3 12 describes the fields in the Remove Directory screen 3787 3213 301 3 55 Removing a Directory on a Remote Host REMOVE DIRECTORY Screen Table 3 12 REMOVE DIRECTORY Screen Fields es The identifier of the remote host where the directory you want to remove is located Use 1 to 255 alphanumeric characters If you
25. messages file a site administrator can use an OS 2200 editor for example ED R To print this file use an SYM U executive control language statement Stored in the DDP PPC log file See the DDP PPC Implementation and Aministration Guide for information on processing this file Example 1 1 illustrates how to access the TAS FTPMSG error messages file This example shows two error messages FTP 320 and FTP 410 The bolded areas show entries you make ED R TAS FTPMSG READ ONLY MODE emsp gt ED 16RID SAT 08 30 97 10 13 40 0 gt EDIT gt 0 gt p 100 gt 97 08 30 15 44 56 FTP monitor is now active gt 97 08 30 00 08 57 gt FTP320 File Transfer Process worker activity received an abort gt indication from the remote host The conversation has been aborted gt 97 08 30 14 25 55 gt FTP410 There is currently not enough memory for FTP to execute gt the current command Please try again later gt EOF 19 gt 0 rexit gt END ED NO CORRECTIONS APPLIED Pt Example 1 1 Accessing the TAS FTPMSG Error Messages File See Appendix A for a list of possible TAS FTPMSG error messages Note For information about recovering from fatal errors see the TAS Implementation and Administration Guide Checkpointing Checkpointing inserts markers in a file so that an interrupted transfer can be restarted from the marker rather than from the beginning 3787 3213 301 What Do I Need to Know to Use Fi
26. 1 to 18 alphanumeric characters continued 3787 3213 301 5 31 Creating a Directory on a Remote Host MKD Command Table 5 11 MKD Command Keyword Parameter Descriptions cont ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 14 shows how to create a directory When a session is open the full pathname is not required because D2 is a subdirectory under the current working directory gt C gt MKD D2 FTP 257 Command processing successfully completed MKD command successful Example 5 14 Creating a Directory on a Remote Foreign Host Using the MKD Command 5 32 3787 3213 301 Printing the Current Directory on a Remote Host PWD Command 5 16 Printing the Current Directory on a Remote Host PWD Command Use the PWD command to print the name of the current working directory on a remote foreign host If you specify a host id any existing session is closed and a new session is opened with the specified host Note When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format PWD HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info Keyword Parameters Table 5 12 describes the keyword parameters for the PWD command Table 5 12 PWD C
27. 3 4 3 1 4 3 2 4 10 Using On Line Help for Commands Types of Help Available Four types of on line help are available e Command help describes the purpose of a command and how to execute it e Parameter help describes an individual parameter for a command e Error message help provides an explanation for a message you receive e FHELP provides a list of available functions implemented on a specified host For more information about FHELP see 5 3 Accessing Command Help Command help provides e A description of the command e The command format To receive help on a command 1 Enter the name of the command followed by a question mark 2 Transmit the command Example 4 9 shows how to access help for the DEALLOCATE command E____ lt _ _SES_ OOOO TTL C gt DEALLOCATE gt The DEALLOCATE command allows you to delete a file on a remote host gt The format of the DEALLOCATE command is gt DEALLOCATE FILE host id file name PASSWORD remote password USERID remote userid CLEARANCE LEVEL clearance level ACCOUNT remote acct no YYYY Y C gt Example 4 9 Accessing Help for a Command In some cases there may be more help available through additional messages To receive any additional help messages 1 Enter a question mark next to the start of entry symbol 3787 3213 301 Using On Line Help for Commands 4 3 3 4 3 4 2 Transmit the command gt C gt
28. 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID BBG File name Zbc ZefZ Wild Card Character Z_ De Register All yes _ NO Accept Data lt gt FTP5095 Command completed successfully G zz _ 3787 3213 301 Getting Help FHELP Screen 3 7 Getting Help FHELP Screen Function FTP implementations can include different functionality For example many implementations do not accept record structure STRUCTURE RECORD Use the FHELP screen to list the available file transfer functions on a e Local host e Remote host You can also use the FHELP screen to check the connection between the local host and another host in the network Screen Figure 3 6 shows the FHELP screen FON FTP 6R1 FHELP 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Accept Data lt gt S Figure 3 6 FHELP Screen Screen Field Descriptions Table 3 6 describes the fields in the FHELP screen 3787 3213 301 3 25 Getting Help FHELP Screen Table 3 6 FHELP Screen Fields es The identifier of the host for which you want a list of available functions This field is required for a remote host if you are not already logged in to that host If no session is established e Omitting the hostid gives help for the local host e Specifying a hostid causes a conn
29. 3213 301 Renaming a File RENAME Screen Table 3 13 RENAME Screen Fields es The identifier of the host where the file resides Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required for a remote host if a session is not currently active For more information about specifying host ids see Section 1 From file name The name of the file you want to rename This must be a valid file name for the system on which the file resides The name cannot contain underscores This field is required For more information about specifying file names see Section 1 To file name The new file name for the file you specify in the From file name field This must be a valid file name for the system on which the file resides The name cannot contain underscores This field is required For more information about specifying file names see Section 1 Password The password as required by the foreign host Use 1 to 18 alphanumeric characters Userid The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters Account The account number as required by the foreign host Use 1 to 12 alphanumeric characters Procedure To rename a file 1 Display the RENAME screen from the Main Menu or from any other com
30. 3787 3213 301 Removing a Directory on a Remote Host RMD Command 5 17 Removing a Directory on a Remote Host RMD Command Use the RMD command to delete a directory on a remote foreign host If you specify a host id any existing session is closed and a new session is opened with the specified host Note When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format RMD DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info Keyword Parameters Table 5 13 describes the keyword parameters for the RMD command Table 5 13 Remove Directory Command Keyword Parameter Descriptions DIRECTORY remote __vate The name of the directory or subdirectory you want to delete on the remote host Use 1 to 132 alphanumeric characters This parameter is required HOST The identifier of the host where you want to delete a directory or subdirectory Use 1 to 255 alphanumeric characters If you omit the host id the host to which you are currently logged in is used Specify a host id if a session is not currently active or if you want to close the current session and open a session with another host For more information about specifying host ids see Section 1 USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric ch
31. 3787 3213 301 Restarting a File Transfer RESUME Command 5 19 Restarting a File Transfer RESUME Command Use the RESUME command to recover a file transfer operation that abnormally terminates You can resume a file transfer that you sent e Within a local host e From a local to remote host e From a remote to a local host e Between remote hosts You can also indicate specifically where you want a file transfer to resume Note The file transfer facility uses a checkpoint file to recover a file transfer Therefore you must have specified a checkpoint file name in the TRANSFER command when you transferred the file If you did not specify a checkpoint file name you cannot recover the file Command Format RESUME FILE file name 1 AT checkpoint id 2 PASSWORD remote password 1 remote password 2 3 CLEARANCE LEVELE irmo cat earance level 1 remote clearance level 2 You can omit the keyword portions FILE AT and PASSWORD when you use positional notation Include the parameter values in this order Keyword Parameters Table 5 15 describes the keyword parameters for the RESUME command Table 5 15 RESUME Command Keyword Parameter Descriptions FILE filename The name of the checkpoint file you specified in the TRANSFER FGET or FPUT command when you transferred the file This must be a valid OS 2200 file name This field is required continued 3787 3213 301 5 39 Restarting a File Transfer
32. Error messages are produced and stored e Checkpoint files are used to restart file transfers 1 3 1 Specifying File and Element Names You must follow certain rules when specifying files and elements for a file transfer Rules exist for both OS 2200 names and non OS 2200 names OS 2200 Hosts When you transfer a file within a local host or between two OS 2200 hosts your options are Transfer an entire file Specify the file name Transfer part of a file Specify the file name and an element name These file characteristics must be considered File Characteristics Sending File Receiving File Must be an existing file w hw o Must follow OS 2200 file naming Yes conventions E a No Yes Can include cycle numbers read Yes Yes write keys and version numbers Must match the file naming style of Yes the file on the opposite system ita receivine file existeih that is whether or not an element keren aan eee niga 3 name en ule DE INEUUEU DEALLOCATE and the file can then be transferred 3787 3213 301 1 7 What Do I Need to Know to Use File Transfer For a complete description of OS 2200 file naming conventions see the Executive System Software Executive Control Language ECL End Use and Programming Reference Manual OS 2200 and Non OS 2200 Hosts 1 3 2 For file transfers between OS 2200 and non OS 2200 hosts follow the file naming conventions appropriate for each host For example if th
33. File Transfer Remote to Local Function Use this format to restart a file transfer from a remote host to a local host Format RESUME FILE file name PASSWORD remote password 1 remote password 2 See Table 5 15 for information about parameter values If you want to specify a restart point see Specifying a Restart Point for a File Transfer Recovery later in this section Example Example 5 20 shows how to restart a file transfer from a remote host to a local host In this example we specify a password for the remote source host gt C gt RESU FILE CHK PASS LMB gt END COMMAND Example 5 20 Restarting a File Transfer from a Remote to a Local Host Using the RESUME Command 5 19 4 Restarting a File Transfer between Remote Hosts 5 42 Function Use this format to restart a file transfer between remote hosts Format RESUME FILE file name PASSWORD remote password 1 remote password 2 See Table 5 15 for information about parameter values 3787 3213 301 Restarting a File Transfer RESUME Command If you want to specify a restart point see Specifying a Restart Point for a File Transfer Recovery later in this section Example Example 5 21 shows how to restart a file transfer between remote hosts In this example we specify a password for the remote source and destination hosts gt C gt RESU FILE CHK PASS LMB FDT gt END COMMAND Example 5 21 Restarting a File Tra
34. MAIN MENU or from any other command screen 2 Ifa session is not already active with the remote host where you want to create a directory enter the name of the remote host in the Host field 3 Inthe Directory field enter the full or partial pathname of the directory or subdirectory you want to create In the Userid field enter the userid which the remote host expects In the Password field enter the password as required by the remote host In the Account field enter the account number as required by the remote host aT oy Ol e Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen 3787 3213 301 3 39 Making a Directory on a Remote Host MAKE DIRECTORY Screen 3 40 Example Example 3 14 shows how to create a subdirectory on a remote host assuming you are already logged in This example assumes that you want to create a subdirectory under your current working directory src tas You can provide the full pathname or only the subdirectory name E a a L a A FTP 6R1 MAKE DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Directory dl Userid Password Account Accept Data lt gt FTP5095 Command completed successfully Ae Example 3 14 Creating a Directory 3787 3213 301 Printing the Current Directory on a Remote Host PRINT WORKING DIRECTORYScreen
35. Print Work Dir lt gt fh Fhelp lt gt dr De register lt gt rd Remove Dir lt gt sr Status Request Aee e aaa a Example 2 2 Accessing a Command Screen using a Command Code Example 2 3 shows how to access the FHELP command screen by positioning the cursor on the MAIN MENU ee ee n i FTP 6R1 FILE TRANSFER PROTOCOL 97 08 30 MAIN MENU Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt Move the cursor to the desired command and transmit or Type the desired command code and transmit File Transfer lt gt tr Transfer lt gt lo Login lt gt al Allocate lt gt re Resume lt gt ge Get lt gt cp Change to Parent lt gt de Deallocate lt gt pu Put lt gt cd Change Work Dir lt gt rn Rename lt gt cl Close lt gt md Make Dir lt gt fs Fsite lt gt rf Register lt gt pw Print Work Dir lt gt fh Fhelp lt gt dr De register lt gt rd Remove Dir lt gt sr Status Request es yf Example 2 3 Accessing a Command Screen Using the Cursor 2 8 3787 3213 301 Using the Menu Interface Accessing a Command Screen from Another Command Screen Each command screen header includes the following field Command lt lt gt To access a command screen from the current command screen 1 Move the cursor to the underlined ara in the Command _ lt gt field of the current screen 2 Enter the two letter command code in front of the angle brackets in the space pro
36. TYPE A Use the same procedure to transfer the file back to the foreign host Program file OS 2200 to Temporary storage to STRUCTURE FILE non OS 2200 be returned to local host TRANSLATE TRANSPARENT When the transfer is initiated by the foreign host the FTP protocol commands should be STRU F and TYPE I ASCII data file OS 2200 to Use on destination host STRUCTURE RECORD non OS 2200 TRANSLATE ASCII When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE A or STRU F and TYPE A continued 3787 3213 301 5 65 Transferring a File TRANSFER Command Table 5 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element ASCII symbolic OS 2200 to Use on destination host STRUCTURE RECORD element non OS 2200 TRANSLATE ASCIl When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE A or STRU F and TYPE A Binary file OS 2200 to Temporary storage to STRUCTURE FILE non OS 2200 be returned to local host TRANSLATE TRANSPARENT When the transfer is initiated by the foreign host the FTP protocol commands should be STRU F and TYPE I Use the same valu
37. Transfer RESUME Screen 3 Inthe From file password field enter the password you specified for the source file on the TRANSFER command screen if the file has read write keys 4 Inthe To file password field enter the password you specified for the destination file on the TRANSFER or PUT screen 5 If you want to specify where to restart a file transfer see Specifying a Restart Point for a File Transfer Recovery later in this section 6 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 14 for additional information about field values Example Example 3 23 illustrates restarting a file transfer from a local host to a remote host ST FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name CHK At checkpoint id From file password Clearance Level _ To file password RHD Clearance Level _ Accept Data lt gt FTP5095 Command completed successfully Example 3 23 Restarting a File Transfer Local to Remote Using the RESUME Screen 3 17 3 Restarting a File Transfer Remote to Local 3 64 Procedure To restart a file transfer from a remote host to the local host 1 Display the RESUME screen from the MAIN MENU or from any other command screen 2 Enter the name of the checkpoint file in the Checkpoint file name field
38. Transfer Situations Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element Program file OS 2200 to Use on destination host STRUCTURE FILE OS 2200 TRANSLATE TRANSPARENT SDF data file OS 2200 to Use on destination host STRUCTURE FILE containing ASCII OS 2200 TRANSLATE TRANSPARENT characters Print file OS 2200 to Print on destination host STRUCTURE FILE OS 2200 TRANSLATE TRANSPARENT Absolute element OS 2200 to Use on destination host 1 Copy the absolute element to an OS 2200 empty program am file on your local host 2 Transfer that file to the destination host using STRUCTURE FILE TRANSLATE TRANSPARENT ASCII symbolic OS 2200 Add to existing program STRUCTURE RECORD element to OS 2200 file on destination host TRANSLATE ASCII POSITION ADD Omnibus element OS 2200 to Use on destination host STRUCTURE RECORD OS 2200 TRANSLATE TRANSPARENT TYPE OMNIBUS continued 5 64 3787 3213 301 Transferring a File TRANSFER Command Table 5 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element ASCII file Non OS 2200 to Temporary seh to STRUCTURE RECORD OS 2200 be returned to foreign TRANSLATE ASCII host When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE A or STRU F and
39. Translate and Structure fields Table 3 17 Guidelines for Using the Type Translate and Structure Fields File or Element Type Translate Transferred SDF file ASCII or EBCDIC File or Record Transparent or L36 File Transparent File Transparent File Program file Programfle fan Transparent or L36 Fie Symbolic Element Sym ASCII or EBCDIC File or Record Saf 2 Transparent File continued 3787 3213 301 Transferring a File TRANSFER Screen Table 3 17 Guidelines for Using the Type Translate and Structure Fields cont File or Element Type Translate Transferred Omnibus Element Transparent or L36 File or Record Transparent File Transparent File 1Only 8 bits of each byte is transferred See Table 3 16for a description of TYPE SDF and TYPE IOW TAS looks for an omnibus element first If not found it then looks for a symbolic element 3 19 7 Sample File Transfer Situations Table 3 18 shows various sample transfer situations Use these samples to help you determine recommended field values for different types of transfers Table 3 18 includes e Type of file or element to be transferred e Types of hosts involved in the transfer e Purpose of the transfer e Recommended field values to specify on the TRANSFER screen When a foreign host is involved we include the FTP protocol commands that TAS receives when the transfer is initiated by the other host Note For these samples the local host is
40. account number as required by the foreign host to access the directory 7 Transmit the screen 3 56 3787 3213 301 Removing a Directory on a Remote Host REMOVE DIRECTORY Screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 12 for additional information about field values Example Example 3 20 shows how to remove a directory on a remote host Cee a aa FTP 6R1 REMOVE DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Directory TAS SAMPLES Userid Password Account Accept Data lt gt FTP 5095 Command completed successfully se o e o Example 3 20 Removing a Directory 3787 3213 301 3 57 Renaming a File RENAME Screen 3 16 Renaming a File RENAME Screen 3 58 Function Use the RENAME screen to rename a file The file must exist on a remote foreign host If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 15 shows the RENAME screen FON FTP 6R1 RENAME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host From file name To file name Userid Password Account Accept Data lt gt a Figure 3 15 RENAME Screen Screen Field Descriptions Table 3 13 describes the fields in the RENAME screen 3787
41. an explanation of the fields on this screen Example Example 3 12 shows a file transfer during a session using the GET screen 3787 3213 301 3 33 Requesting a File During a Session GET Screen 3 34 J FTP 6R1 GET 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source File Name on remote host TEST FILE SENT Destination File Name on local host TEST FILE RECEIVED Type SYM All _ Om _ Sdf _ Iow _ Max Record Size Translate Transparent Ascii Ebcdic L36 Mode STREAM Block Compressed Position REPLACE Add _ Structure FILE Record Checkpoint mark Checkpoint File Name Userid Password Level Account Project remote Siteinfo Accept Data lt gt Ae Example 3 12 Transferring a File Using the GET Screen 3787 3213 301 Opening a Session with a Remote Host LOGIN Screen 3 10 Opening a Session with a Remote Host LOGIN Screen Function Use the LOGIN screen to establish a session with a remote host When a session between two hosts has been established files can be transferred in either direction over the open path using GET and PUT The use of a session saves administrative overhead for frequent file transfers Only one session is permitted at a time When you transmit the LOGIN screen any existing session is closed and a new session is opened with the specified host For more information about sessions re
42. appear multiple times in the checkpoint file For information about how to specify checkpointing information to the file transfer facility when you initiate a file transfer see 3 19and 5 20 3787 3213 301 1 13 What Do I Need to Know to Use File Transfer Results of an Unsuccessful File Transfer When you use a checkpoint file to restart a file transfer checkpointing is still in effect The file transfer facility continues to write checkpoint markers to the same checkpoint file Results of a Successful File Transfer After a successful file transfer for which checkpointing was requested the contents of the checkpoint file are no longer useful The action that the file transfer facility takes with the checkpoint file depends on how it was allocated You allocate catalog the checkpoint file before The file transfer facility records an indication in initiating the file transfer the checkpoint file that the file transfer was successfully completed and frees it The checkpoint file does not exist when the The file transfer facility allocates it and then transfer is initiated deletes it upon successful completion of the transfer 1 14 3787 3213 301 Section 2 Getting Started with the Menu Interface 2 1 Starting and Ending a Menu Interface Session Obtain the following information before you begin your first session e Format type for specifying host ids See Section 1 e Log on procedure in use at your site
43. cannot transfer a file e Within a foreign host e Between two remote foreign hosts e Between a remote OS 2200 host and a remote foreign host You can also request notification of a successful file transfer to an OS 2200 host The following examples show ways to use the file transfer facility and the various directions in which you can transfer a file e You want to create a copy of a program file on the local host that you can use to modify and test Local Host e You create a file on the local host and want to store it on a remote host that has more mass storage You transfer the file from the local to the remote host 3787 3213 301 1 3 What Is the File Transfer Facility Local Remote Host Host e You want to execute programs on the local host that currently reside on a remote host You transfer the program file from the remote to the local host Local Z Remote Host Host e You need to run some reports on a remote host The data file you need to run the reports resides on another remote host Transfer the data file between the remote hosts Note that these remote hosts must be OS 2200 hosts Remote Host A v Remote Host Local Host 1 2 2 Types of Files and Elements Using the file transfer facility you can transfer e Complete files of these types OS 2200 System Data Format SDF OS 2200 prog
44. ese id eh a eA e e Melee iaeia 3 58 Fi RESUME SCreen eriei eA P aa en A A ake 3 61 3 17 STATUS REQUEST Screen eee 3 69 3 18 TRANSFER Screen 0 cc eee 3 73 3787 3213 301 IX Tables 1 1 Overview of File Transfer Functions 60 eee 1 5 2 1 Function Key Section Requests 6 eee 2 4 2 2 Filling in Command Screen Fields 0 0 0 00 ccc eee 2 6 3 1 ALLOCATE Screen Fields 0 cece cee 3 3 3 2 CHANGE TO PARENT DIRECTORY Screen Fields 5 3 6 3 3 CHANGE WORKING DIRECTORY Screen Fields 05 3 9 3 4 DEALLOCATE ScreeniFieldS 220 4 direii dnra e aE aoa E ne ee 3 12 3 5 DREGISTER Screen Fields 6k eee ee 3 15 3 6 FHEEP Scr en FieldS iinei naer ae ae hi ea Shenk iba Bae aed 3 26 3 7 RolTE Screen Fields i ac cacce secede ot east nar oie Pace thes beatae 6 3 31 3 8 LOGIN Sereen Fields o oran Pit eos tne eoa e due ede Mee ea 3 36 3 9 MAKE DIRECTORY Screen Fields 0 eee 3 39 3 10 PRINT WORKING DIRECTORY Screen Fields 0000 004 3 42 3 11 REGISTER Screen Fields 66 cee 3 50 3 12 REMOVE DIRECTORY Screen Fields 0 eee 3 56 3 13 RENAME Screen Fields tiran mita d p cece 3 59 3 14 RESUME Screen Fields 2 0 cee 3 62 3 15 STATUS REQUEST Screen Fields 0 00 0 3 69 3 16 TRANSFER Screen Fields lt c2c bee vedi dp e EE EARE REER 3 73 3 17 Guidelines for Using the Type Translate and Structure Fields 3 92 3 18 Sample File Tran
45. file transfer e Restart a file transfer from any one of the checkpoint ids reported in the checkpoint file If you leave this field blank the transfer resumes at the last checkpoint id in the checkpoint file To determine a restart point you need to access the checkpoint file For additional information on checkpointing see Section 1 Procedure To restart a file transfer by specifying a restart point 1 Display the checkpoint file using any OS 2200 editor 3 66 3787 3213 301 Restarting a File Transfer RESUME Screen Caution Do not change the contents of the checkpoint file If you do you may not be able to recover the file 2 Select a checkpoint id from the checkpoint file to use as the restart point for the file transfer The checkpoint id is located after the word MARK and before the equal sign If you omit the hyphen and the 0 a value of 0 is assumed For example MARK 1920 0 1920 0 16 17 41 In this example you can specify the checkpoint id as 1920 0 or 1920 with the same effect 3 Inthe Checkpoint file name field enter the name of the checkpoint file you specified on the TRANSFER GET or PUT screen 4 Inthe At checkpoint id field enter the checkpoint id you selected in step 2 5 Inthe From file password field enter the password you specified for the source file on the TRANSFER or GET command screen 6 Inthe To file password field enter the password you specified for the destination
46. from the MAIN MENU or from any other command screen 2 Inthe Application ID field enter the name of the application 3 Inthe De Register All field select YES Transmit TAS then displays a completion message at the bottom of the screen See Table 3 5 for additional information about field values 3 16 3787 3213 301 Deregistering a File DREGISTER Screen Example The registered files associated with application id AAA are File 1 bbc eef Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BBC EEF File 2 rrr adfgg Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character RRR ADFGG The registered files associated with application id BBG are File 1 abc def Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character A AA BCDHH CCE File 2 uopt abc ggh Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character UOPT ABC GGH The result is Both entries under application id AAA are removed Example Example 3 6shows how to deregister all file names associated with an application id 3787 3
47. id on certain FTP commands For more information about sessions see Methods of Transferring Files in 1 3 To close a session enter cl on the command line of any command screen or select the close option from the MAIN MENU There is no CLOSE command screen Exiting File Transfer To end the file transfer program 1 Display either e The MAIN MENU e Any command screen 2 You can either e Press the F3 function key e Move the cursor to F3 Exit lt gt and transmit If you end the file transfer program while a session is open the session is closed before the file transfer program ends 3787 3213 301 Using the Menu Interface 2 2 Using the Menu Interface 2 2 1 Sections of a Command Screen A command screen has four sections Figure 2 1 e Header section e Function key section e Command section e Message section FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Om _ Sdf Iow_ Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE _ Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Project 1 Source t 2 Dest k Siteinfo Accept Data lt gt I eee Be a ti lt i C Figure 2 1 Sample Command Screen
48. local host to a remote host e From aremote host to the local host e Between remote OS 2200 hosts Except for transfers between files on the local host you always provide a remote host id on the TRANSFER command When you issue a TRANSFER command the following steps take place If a session is currently open it is closed A new session is established The transfer takes place Pw N a The session is closed At the completion of the TRANSFER command there is no open session Transferring Files using GET and PUT Commands 1 10 The LOGIN command establishes a session with a remote host While the session is open you can issue e GET commands to transfer files from a remote host to the local host e PUT commands to transfer files from the local host to a remote host You do not provide a remote host id on the GET or PUT command 3787 3213 301 What Do I Need to Know to Use File Transfer The session remains open until you issue a CLOSE or LOGOUT command or until you open another session Using Other FTP Commands in an Open Session 1 3 4 Once a session is established with a remote host you can issue a number of FTP commands in addition to GET and PUT The following commands can be used in an open FTP session e ALLOCATE e CHANGE TO PARENT DIRECTORY CDUP e CHANGE WORK DIRECTORY CWD e DEALLOCATE e FHELP e FSITE e MAKE DIRECTORY MKD e PRINT WORKING DIRECTORY PWD e REMOVE DIRECTORY RMD
49. more specific instructions about a file transfer Using the TRANSFER command you can e Define the sending file or element type e Define maximum record length in the transmission file e Identify data representation in the transmission file e Place or replace data in the receiving file e Define transmission data e Identify when to take a checkpoint mark e Define data structure in the transmission file e Create a checkpoint file e Specify site information requested by a foreign host The parameter values you specify in the TRANSFER command depends on the e Type of file you transfer For example you can transfer ASCII data EBCDIC data Binary data AnSDF file A program file An element of a program file e Types of hosts involved in the transfer For example you can transfer Toor from an OS 2200 host Toor from anon OS 2200 host 5 46 3787 3213 301 Transferring a File TRANSFER Command e Purpose of the transfer For example you can transfer a file to a destination host for Temporary storage Use or processing To help you determine which values to specify in the TRANSFER command see File Transfer Guidelines later in this section Command Format TRANSFER FROM host id 1 file name 1 element name 1 1 T0 host id 2 file name 2 element name 2 2 PASSWORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 CLEARANCE LEVEL clearance level
50. most efficient structure when transferring between OS 2200 hosts When you use FILE when transferring an entire file file control information associated with an OS 2200 SDF file is transmitted to the remote host This can make the file unreadable to a non OS 2200 host although the file becomes readable when returned to the originating OS 2200 host The default is FILE STRUCTURE RECORD Transfers the file in sequential record continued format Use this structure when the destination host s file structure is record oriented The file transfer facility includes record trailers during transmission Use this option when you transfer data to a non OS 2200 host with a file structure that may be incompatible with OS 2200 file formats STRUCTURE RECORD transmits only the data portion in a record oriented file or element such as n SDF file or symbolic element This data is readable on any host MAX_RECORD_SIZE 7168 Indicates the largest number of bytes to be passed as a message to DDP PPC when STRUCTURE RECORD is specified The default is 7168 bytes one track The default is strongly recommended The maximum is 7168 bytes continued 3787 3213 301 5 53 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont MAX_RECORD_SIZE nnnnn Specifies the number of bytes when the continued default is not valid Specify a value when the destination host supports ma
51. on the other host TAS uses SDF input output to access the file or element This type is not supported for transfers between OS 2200 hosts TYPE continued SOURCE Transfers an ASCII text file This type is not supported for transfers between OS 2200 hosts TYPE continued IOW Transfers a file or omnibus program element as 8 bit binary data e For a source file the 9th high order bit of the bytes in the last written track of the file is used to indicate the end of file The first byte in the last written track with the 9th bit on indicates no more data is to be transferred In the tracks preceding the last written track the 9th bit of each byte is meaningless and ignored For a destination file each eight bits of incoming data are stored in a byte with the 9th bit off zero When the last eight bits are stored the next byte is set to octal 400 9th bit is on to indicate the end of file All file control information is also ignored not transferred This is useful when the data portion of the file or element is usable on the other host TAS uses ERIOWS to access the file or element This type is not supported for transfers between OS 2200 hosts continued 3787 3213 301 5 51 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont TRANSLATE ASCII ASCII is the most efficient data type between OS 2200 hosts The default is e ASCII when you t
52. only transferring in one direction and that a session is open between the two hosts Screen Figure 3 12 shows the PUT screen ee FTP 6R1 PUT 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source File Name on local host Destination File Name on remote host Type SYM ATT Omn _ Sdf Tow Max Record Size Translate Transparent Ascii Ebcdic L36 Mode STREAM Block Compressed Position REPLACE _ Add _ Structure FILE Record _ Checkpoint mark Checkpoint File Name Userid Password Level Account Project local Siteinfo Accept Data lt gt seo Figure 3 12 PUT Screen Screen Field Descriptions Refer to the discussion of the TRANSFER screen for an explanation of the fields on this screen Example Example 3 16 shows a file transfer during a session using the PUT screen 3787 3213 301 3 43 Sending a File During a Session PUT Screen 3 44 T_T FTP 6R1 PUT 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source File Name on local host TEST FILE Destination File Name on remote host NEW TEST FILE Type SYM AIT _ Om Sdf _ Iow _ Max Record Size Translate Transparent Ascii Ebcdic L36 Mode STREAM Block Compressed Position REPLACE Add _ Structure FILE Record Checkpoint mark Checkpoint File Name E Userid Password Level Account Project local
53. parameter Omit the brackets when you enter the parameter STRUCTURE FILE RECORD Indicates a choice of values from which you must select In some cases you can enter more than one value STRUCTURE FILE RECORD In command formats bold indicates a default value that the file transfer facility automatically enters LOGOFF In examples bold indicates a user entry Number after BYTES integer 1 Indicates that you can use positional parameter notation for this parameter and the required positional sequence Note Our production system does not permit both italics and bold for the same term You can abbreviate the following values which are not in italics in the command formats SYMBOLIC SYMB STREAM STRE and REPLACE REPL 4 2 3 Parts of a Command A file transfer command consists of e Averb e One or more keyword parameters Example 4 4 shows a sample command 4 4 3787 3213 301 Using the Command Interface gt C gt TRANSFER FROM UCLA SDFFILE TO SD 01 SDFFILE Example 4 4 Sample File Transfer Command A parameter can be required or optional You can enter more than one parameter for some commands The command in Example 4 4 includes only two required parameters however there are many optional parameters you can also specify 4 2 4 Entering a Command You can enter a command using either e Keyword syntax e Positional notation e A combination of keyword syntax and positional notat
54. portion in a record oriented file or element such as an SDF file or symbolic element This data is readable on any host Checkpoint file name The name of the file that contains a record of the transfer commands and options and that records checkpoint ids throughout a transfer You must specify a checkpoint file name to use the RESUME screen The RESUME screen lets you restart a file transfer that abnormally terminates You cannot specify a checkpoint file if STREAM is specified for the mode field This must be a valid OS 2200 file name continued 3 78 3787 3213 301 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont S 1 Source Subfield Description Userid The user identifier for the source host Use 1 to 12 alphanumeric characters This field is required when the file resides on a remote host This field is required when the file resides on your local host and has read write keys or has a USE name attached to it The default is your user id on your local host Password The password for the source host Use 1 to 18 alphanumeric characters This field is generally required when the file is on a remote host This field is required when the file resides on your local host and has read write keys or has a USE name attached to it The default is blank characters Level The clearance level for the source host Enter a number between 0 and 63 Account The account numbe
55. the following format to enter e All of the required information for the particular type of transfer you want to perform See previous subsections e Any additional information Guidelines and examples follow this page TRANSFER FROM host id 1 file name 1 element name 1 T0 host id 2 file name 2 e ement name 2 PASSWORD remote password 1 remote password 2 USERID remote user id 1 remote user id 2 FE KEARANCE LEVEL clearance level ACCOUNT Temote account info 1 remote account info 2 LTYPE SYMBOL IC ALL OMNIBUS ISDF SOURCE OW TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POSTION REPLACE ADD CHECKPOINT file name 3 MARK 250 integer SITEINFO information 3787 3213 301 5 59 Transferring a File TRANSFER Command 5 60 See Table 5 16 for information about parameter values Examples Example 5 28 shows how to transfer an omnibus element within the local host gt C gt TRANSFER FROM OMNFILE TST TO ZZZ FILE OMNTEST amp gt C amp gt TYPE OMN Example 5 28 Transferring an Omnibus Element within the Local Host Using the TRANSFER Command In this example you can omit the TRANSLATE and STRUCTURE keyword parameters because TRANSPARENT and FILE are the defaults Example 5 29 shows how to transfer a symbolic element from a remote host to a local host gt C gt TRANSFER FROM
56. the possible combination of values you can specify for the Type Translate and Structure parameters Table 5 17 Guidelines for Using the Type Translate and Structure Parameters File or Element Type Translate Transferred SDF file ASCII or EBCDIC File or Record Transparent or L36 File Transparent File C T File Program file file A TransparentorL36 or L36 Fe Symbolic Element Sym ASCII or EBCDIC File or Record Saf 2 Transparent File Omnibus Element Transparent or L36 File or Record Transparent File Transparent File 1Only 8 bits of each byte is transferred See Table 5 16for a description of TYPE SDF and TYPE IOW TAS looks for an omnibus element first If not found it then looks for a symbolic element 5 20 7 Sample File Transfer Situations Table 5 18 shows various sample transfer situations Use these samples to help you determine recommended parameter values to perform different types of transfers Table 5 18 includes e Type of file or element to be transferred e Types of hosts involved in the transfer e Purpose of the transfer 3787 3213 301 5 63 Transferring a File TRANSFER Command e Recommended parameter values to specify on the TRANSFER screen When a foreign host is involved we include the FTP protocol commands that TAS receives when the transfer is initiated by the other host Note For these samples the local host is an OS 2200 host with TAS installed Table 5 18 Sample File
57. to z A to Z and 0 to 9 The name cannot contain underscores This field is required continued 3787 3213 301 3 15 Deregistering a File DREGISTER Screen Table 3 5 DREGISTER Screen Fields cont ee File name The name of the file that TAS should use to find the file name s to deregister This must be a valid OS 2200 name This identifier is not required if you want to deregister all the files registered to the specified application id Wild Card Specifies which character in the file name field TAS should replace with a wild Character card indicator when it creates the deregister file id Use only one character The character must be one of the characters in the file name field excluding the file name separator characters such as comma asterisk parentheses period or slash De Register All Indicates whether or not TAS should deregister all file name matches or just an exact match YES If the file name field is not entered then deregister all the files associated with the specified application ID If a value is entered for the file name then deregister all files associated with the specified application ID which also match teh file name NO Deregister only the file specified in the file name field The default is NO 3 6 1 Deregistering All File Names Associated with an Application ID Procedure To deregister all the file names associated with an application ID 1 Display the DEREGISTER screen
58. 012345 Character A CAA 5 Digss35 so5 CGIE seg 5 53 3 File 2 AZZAA BCDHH CCE where Z is a wild card File 2 has the following file id Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character A AA BCDHH CCE 3 48 3787 3213 301 Registering a File for Event Notification REGISTER Screen The comparison values assigned to the file id would then be Part File 1 Values File 2 Values Qualifier 11 10 Filename 8 12 Element 2 12 Cycle 3 3 Read Key 6 6 Write Key 6 6 Element Name 12 12 Element Version 12 12 Total 60 73 Both file ids are acceptable because the incoming file id matches all the characters in both the registered file ids However file 2 has a higher total comparison value 73 than file 1 File 2 is therefore the best match 3 14 3 The Register Screen This section shows the Register screen and describes the fields on the screen Screen Figure 3 13 shows the REGISTER screen eX a ee S A FTP 6R1 REGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID Filename Runstream Start Options Control Value Wild Card Character _ One Time Registration yes NO Save Filename and Status yes NO _ Initiate add _ start _ Accept Data lt a eae Figure 3 13 REGISTER Screen 3787 3213 301 3 49 Registerin
59. 1 Display the STATUS REQUEST screen from the MAIN MENU or from any other command screen 2 Enter the name of the application in the Application ID field 3 Transmit the screen The file transfer facility then displays the filename and status If there are any errors the errors are displayed at the bottom of the screen and the filename and status are not displayed Example Example 3 28 illustrates getting the saved status 3 70 3787 3213 301 Getting Filename and File Registration Status STATUS REQUEST Screen Bom pel T RN FTP 6R1 STATUS REQUEST 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID ftpappl De Register Entry yes _ NO Filename received Qual Filename File Status Accept Data lt gt Seo l Example 3 28 Using the STATUS REQUEST Screen 3787 3213 301 3 71 Transferring a File TRANSFER Screen 3 19 Transferring a File TRANSFER Screen 3 72 Function Use the TRANSFER screen to transfer a copy of a file or element e Within a local host e From a local to a remote host e From a remote to a local host e Between remote OS 2200 hosts Optionally you can include more specific instructions about a file transfer Using the TRANSFER screen you can e Define the sending file or element type e Define maximum record length in the transmission file e Identify data representation in the transmission file e Pl
60. 1 3 89 Transferring a File TRANSFER Screen BO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name FILE1 Destination Host 4 3 0 3 Destination File Name FILE1 Type SYM _ All _ Om _ Sdf _ Tow Max Record Size Translate Transparent Ascii x Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record x Checkpoint mark Checkpoint file name Userid Password Level Account Project Source BCNET1 SNS E Dest SITEJB DAS B Siteinfo Accept Data lt gt FTP5095 Command completed successfully ee 3 19 6 Example 3 36 Transferring a Local File to a Remote File as Sequential Records File Transfer Guidelines Use the following guidelines to help you determine which field values to specify on the TRANSFER GET and PUT screens Sample transfer situations follow this information Guidelines for All Types of Transfers For all types of transfers follow these guidelines 3 90 Know what types of hosts are involved in a transfer TAS recognizes the types of hosts OS 2200 versus foreign host involved in a file transfer and transfers a file according to this information Know the level of FTP implementation for each host See the FHELP screen or command Different remote hosts may implement file transfer in different ways For example many implement
61. 213 301 3 17 Deregistering a File DREGISTER Screen OS FTP 6R1 DREGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID AAA File name Wild Card Character De Register All yes NO Accept Data lt gt FTP5095 Command completed successfully eaaa aI aoo Example 3 6 Deregistering All FilenamesAssocaited with an Application id 3 6 2 Deregistering FilenamesThat Have No Associated Wildcard 3 18 Procedure To deregister filenames that have no associated wildcard 1 Display the DEREGISTER screen from the MAIN MENU or from any other command screen 2 Inthe Application ID field enter the name of the application 3 Inthe File name field enter the name of the file to be deregistered 4 Transmit TAS then displays a completion message at the bottom of the screen See Table 3 5 for additional information about field values Example The registered files associated with application id AAA are File 1 bbc eef Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BBC EEF File 2 rrr adfgg Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character RRR ADFGG 3787 3213 301 Deregistering a File DREGISTER Screen
62. 301 Examples 5 21 5 22 5 23 5 24 5 25 5 26 5 27 5 28 5 29 5 30 5 31 3787 3213 301 Restarting a File Transfer between Remote Hosts Using the RESUME Command secme a a a a O a Gale a r a Sal Sample Checkpoint File 6 cee Specifying a Restart Point Using the RESUME Command Transferring an Element within the Local Host Using the TRANSFER COMMA esenee aea rie rade Math nde ESNE e lt r heat Gnawa rik Transferring a File Local to Remote Using the TRANSFER Command Transferring a File Remote to Local Using the TRANSFER Command Transferring an Element between Remote Hosts Using the TRANSFER Command 24ers rah eta oh ai esd eng nt od Transferring an Omnibus Element within the Local Host Using the TRANSFER Command 2 eens Transferring a Symbolic Element from a Remote Host to the Local Host Using the TRANSFER Command 0 0 0 2 cece eee Transferring a File Containing Ebcdic Code from the Local Host to a Remote Host Using the TRANSFER Command 0 ee eee Transferring a Local File to a Remote File as Sequential Records XV 5 43 5 44 5 45 5 56 5 56 5 57 5 58 5 60 5 60 5 60 5 60 About This Guide This manual provides information about the Unisys file transfer facility designed for use in a TCP IP network The Unisys networking product is called TAS TCP IP Application Services The product name TAS replaces DDN 1100 Defense Data Network The term TAS g
63. 32 alphanumeric characters This field is required Password The password as required by the foreign host Use 1 to 18 alphanumeric characters Userid The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters Account The account number as required by the foreign host Use 1 to 12 alphanumeric characters Procedure To transfer information requested by a foreign host 1 Display the FSITE screen from the MAIN MENU or from any other command screen 2 Inthe Host field enter the identifier of the foreign host that requires the FSITE information if you are not currently logged in to that host 3 Inthe Information field enter the information for the foreign host 3787 3213 301 3 31 Transferring Information Requested by a Foreign Host FSITE Screen In the Password field enter the password as required by the foreign host In the Userid field enter the userid as required by the foreign host In the Account field enter the account number as required by the foreign host Toy pi je Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen Example Example 3 11 shows how to transfer FSITE information requested by a foreign host S tC FTP 6R1 FSITE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host 6 3 0 3 Information CWD home guest4 tempfiles Use
64. 32 alphanumeric characters This parameter is required The password as required by the foreign host Use 1 to 18 alphanumeric characters The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters ACCOUNT Use 1 to 25 alphanumeric characters Example Example 5 12 shows how to transfer information requested by a foreign host In this example we omit the keyword HOST because we are using positional notation gt C gt FSITE SD 01 INFO CWD home guest4 tempfiles gt END COMMAND gt Example 5 12 Transferring Information Using the FSITE Command 3787 3213 301 5 25 Getting File Registration Status FSTATUS Command 5 12 Getting File Registration Status FSTATUS 5 26 Command Use the FSTATUS command to get the saved filename and file status that is saved for the user You might then choose to deregister the filename Note The status is not saved unless you previously specified the Save Filename and Status option Command Format FSTATUS USERID application id DREG ENTRY YES NO Keyword Parameters Table 5 9 describes the keyword parameters for the FSTATUS command Table 5 9 FSTATUS Command Keyword Parameter Descriptions USERID application id This identifies the owner of the event notification record Use 1 to 12 alphanumeric characters a to z Ato Z and 0 to 9 This is a required field DREG_ENTRY YES Deregisters the filename record
65. 345678901234567890123456789012345 Character UOPT ABC GGH File 3 abZ aefbcd wild card Z Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 File 4 abc hef111 Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character ABC HEF111 File 5 pbc jefr Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character PBC JEFR File 6 abc aefa Wild card a Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BC SE Pssises 5 iiei 3787 3213 301 3 23 Deregistering a File DREGISTER Screen 3 24 File 7 abc aefa Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character ABC AEFA The file id generated from the Deregister command filename is Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BC SE Piseecshe asn The result is File 6 under application id BBG is removed SS re ooo FTP 6R1 DREGISTER 97 08
66. 6R1 FHELP INFORMATION 97 08 30 The AJAX Model 100 Operating System provides a file transfer protocol FTP implementation that includes the basic set of commands Specifically the following commands are supported USER QUIT PORT TYPE MODE STRU RETR STOR NOOP Appropriate error messages are returned when commands other than those listed above are attempted F4 Return To Menu lt gt F5 Return To Command lt gt ee ee ee ee e Example 3 10 Response to Listing Available Functions on a Remote Host Using the FHELP Screen Note the use of the following fields at the bottom of the response screen F4 Return To Menu lt gt Displays the Main Menu F5 Return To Command lt gt Displays the FHELP screen 3787 3213 301 3 29 Transferring Information Requested by a Foreign Host FSITE Screen 3 8 Transferring Information Requested by a Foreign Host FSITE Screen Function Use the FSITE screen to send FTP protocol not supported by TAS command screens This screen may only be used to send protocols to a remote non OS 2200 host Note that you can also include FSITE information on the TRANSFER GET and PUT screens however some FTP implementations require you to use the FSITE screen prior to performing any other FTP functions This screen functions like the FTP QUOTE protocol in that whatever information you key in is sent to the remote host However TAS does not allow all protocols to be sent If you ent
67. 7 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID ftpappl Filename Qual Filex Runstream Start File Element Start Options Control Value Wild Card Character X_ One Time Registration yes NO Save Filename and Status yes NO _ Initiate add __ START _ Accept Data lt gt SO _s ssbsbc_c_cL LLlLLl____ 2___j Example 3 18 Registering a Filename with a Wildcard Character 3 14 6 Registering Using One Time Registration and Save Status Procedure To register a filename with options 1 Display the REGISTER screen from the MAIN MENU or from any other command screen Enter the name of the application in the Application ID field Enter the filename in the Filename field Enter the runstream in the Runstream field In the One Time Registration field indicate that you want one time registration Do FF WN In the Save filename and Status field indicate that you want the filename and file status saved 7 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 11 for additional help about field values Example Example 3 19 shows how to register using the options 3787 3213 301 3 53 Registering a File for Event Notification REGISTER Screen T_T FTP 6R1 REGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _
68. 789012345678901234567890123456789012345678901234567890123456789012345 Character UOPT ABC GGH File 3 abZ aefbcd wild card Z Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 File 4 abc hef111 Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character ABC HEF111 File 5 pbc jefr Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character PBC JEFR The file id generated from the Deregister command filename is Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BCT sEFsss3333333 3787 3213 301 3 21 Deregistering a File DREGISTER Screen The result is Files 1 4 and 5 under application id BBG are deregistered SS FTP 6R1 DREGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID BBG File name Zbc ZefZ Wild Card Character Z De Register All yes X NO Accept Data lt gt FTP5095 Command completed successfully _ nl 3 6 4 Deregistering FilenamesThat Were REgistered With a Wildcard P
69. AB 01 FTEST ELT TO FTPTEST ELT amp gt C amp gt PASS A STRU FILE TRANSLATE ASCII Example 5 29 Transferring a Symbolic Element from a Remote Host to the Local Host Using the TRANSFER Command Example 5 30 transfers a symbolic file containing EBCDIC code from the local host to a remote host gt C gt TRANSFER FROM SDFTEST TO AB 01 ZZZ SDF1 PASS A amp gt C amp gt TRANSLATE EBCDIC STRU RECORD TYPE SYM Example 5 30 Transferring a File Containing Ebcdic Code from the Local Host to a Remote Host Using the TRANSFER Command Example 5 31 transfers a local file to a remote file as sequential records gt C gt TRANSFER FROM DAY FILES TO AC 02 DAY2 FILE2 amp gt C amp gt PASS Z STRU RECORD TRANSLATE ASCII Example 5 31 Transferring a Local File to a Remote File as Sequential Records 3787 3213 301 Transferring a File TRANSFER Command 5 20 6 File Transfer Guidelines Use the following guidelines to help you determine which parameter values to specify in the TRANSFER command Sample transfer situations follow this information Guidelines for All Types of Transfers For all types of transfers follow these guidelines Know what types of hosts are involved in a transfer TAS recognizes the types of hosts OS 2200 versus non OS 2200 host involved in a file transfer and transfers a file according to this information Know the level of FTP implementation for each host See FHELP FTP protoc
70. ALLOCATE command to reserve file storage space on a remote foreign host if required by that host If you specify a host id any existing session is closed and a new session is opened with the specified host Note When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format ALLOCATE BYTES integer 1 RECORDS integer 2 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info Keyword Parameters Table 5 1 describes the keyword parameters for the ALLOCATE command Table 5 1 ALLOCATE Command Keyword Parameter Descriptions BYTES integer Specifies the maximum allowable file size in bytes for the file you want to transfer Size requirements are defined by the remote host This parameter is required even when you specify the RECORDS parameter RECORDS integer Specifies the maximum allowable size in records of the file you want to transfer Size requirements are defined by the remote host continued 5 2 3787 3213 301 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Command Table 5 1 ALLOCATE Command Keyword Parameter Descriptions cont HOST host id The identifier of the host where you want to reserve file storage Use 1 to 255 alphanumeric characters If you omit the host id the host to which you are currently logged in is used Specify a host id if a s
71. DREGISTER Deregisters a file for event notification Lists available file transfer functions implemented on e Your local host e Aremote host FSITE Transfers information not included in the FTP protocol commands GET FGET Transfers a file to the local host during a session with a remote host LOGIN Establishes a session with a remote host MAKE DIRECTORY MKD Makes a new directory on a remote foreign host using the name pathname PRINT WORKING Displays on your terminal the name of the current working DIRECTORY PWD directory on a remote foreign host continued 3787 3213 301 1 5 What Is the File Transfer Facility Table 1 1 Overview of File Transfer Functions cont Screen Command RESUME Uses previously defined checkpoint files to restart an abnormally terminated file transfer Within your local host From your local to a remote host From a remote to your local host Between remote hosts STATUS REQUEST FSTATUS Obtains file transfer status for files with event notification set TRANSFER Transfers a copy of a file Within your local host From your local to a remote host From a remote to your local host Between remote OS 2200 hosts 1 6 3787 3213 301 What Do I Need to Know to Use File Transfer 1 3 What Do I Need to Know to Use File Transfer To use the file transfer facility you need to understand how e File and file elements are named e Hosts are identified e Sessions are established e
72. DREGISTER command Table 5 5 DREGISTER Command Keyword Parameter Descriptions USERID application id This identifies the owner of the event notification record This is a required field The name of the file that TAS should use to find the file name s to deregister This must be a valid OS 2200 name This identifier is not required if you want to deregister all the files registered to the specified application id wild character Specifies which character in the file name field TAS should replace with a wild card indicator when it creates the deregister file id Use only one character The character must be one of the characters in the file name field excluding the file name separator characters such as comma asterisk parentheses period or slash continued 5 12 3787 3213 301 Deregistering a Filename DREGISTER Command Table 5 5 DREGISTER Command Keyword Parameter Descriptions cont DREG_ALL YES Indicates whether or not TAS should deregister all file name matches or just an exact match YES If the file name field is not entered tihen deregister all th associated with the specified application ID If a value is for the file name then deregister all files associated wit specified application ID which also mitch teh file name NO Deregister only the file specified in the file name field The default is NO 5 6 1 Deregistering a Single Filename Function Use this format to deregister a s
73. EALLOCATE Screen 3 5 2 Deleting a File on a Remote Host Procedure To delete a file on a remote host 1 Display the DEALLOCATE screen from the MAIN MENU or from any other screen 2 Inthe File name field enter the name of the file you want to delete 3 Ifa session is not already active with the remote host where the file resides enter the name of the remote host in the Host field 4 Inthe Userid field enter the user identifier as required by the remote host 5 Inthe Password field enter the password as required by the remote host 6 Inthe Account field enter the account number as required by the remote host 3787 3213 301 3 13 Deleting a File DEALLOCATE Screen 3 14 7 Inthe Project field enter the project identifier as required by the remote host 8 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 4 for additional information about field values Example Example 3 5 shows how to delete a file on a remote host In actual practice userid and password are not displayed nr i S A FTP 6R1 DEALLOCATE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt File name SYMFILE Host KP 01 Userid Password Clearance Level Account Project SITFJB SNS 12 ST 103 COMMS Accept Data lt gt FTP5095 Command completed successfully eee eee eee eee eae Example 3 5 D
74. ITE information in the TRANSFER command however some FTP implementations require you to use the FSITE command prior to performing any other FTP functions If you specify a host id any existing session is closed and a new session is opened with the specified host Command Format FSITE HOST hostid 1 INFORMATION information 2 PASSWORD remote password USERID remote user id ACCOUNT remote account info You can omit the keyword portion HOST when you use positional notation Keyword Parameters Table 5 8 describes the keyword parameters for the FSITE command Table 5 8 FSITE Command Keyword Parameter Descriptions HOST hostid The identifier of the foreign host Do not use this parameter if a session is currently open to the desired host If you enter a host name the session is closed and a new session is opened to the specified host When the command completes the session remains open Use 1 to 255 alphanumeric characters For more information about specifying host ids see Section 1 continued 3787 3213 301 Transferring Information Requested by a Foreign Host FSITE Command Table 5 8 FSITE Command Keyword Parameter Descriptions cont E PASSWORD remote password B The FTP protocol to be sent to the foreign host This information must be enclosed in double quotes The following FTP protocols are the only ones that may be entered ALLO MKD RMD CDUP NOOP SITE CWD PWD SMNT Use 1 to 1
75. LEVEL clearance level ACCOUNT r mote account i nfof You can omit the keyword portions FILE and PASSWORD when you use positional notation Include the parameter values in this order Keyword Parameters Table 5 4 describes the keyword parameters for the DEALLOCATE command 3787 3213 301 Deleting a File DEALLOCATE Command Table 5 4 DEALLOCATE Command Keyword Parameter Descriptions FILE filename PASSWORD remote password USERID remote user id CLEARANCE_LEVEL clearance level 3787 3213 301 The host id is the identifier of the host where the file resides Do not use this field during an open session if you wish to communicate with the current host If you enter a host name the session is closed and a new session is opened to the specified host When the command is done the session remains open For more information about specifying host ids see Section 1 The file name is the name of the file you want to delete This must be a valid file name for the system on which the file resides For more information about specifying fine names see Section 1 The password as required by the host where the file resides This field is required when the file resides on a local host and the file has read write keys Use 1 to 18 alphanumeric characters The user identifier as required by the remote host Use 1 to 12 alphanumeric characters The clearance level as required by the remote h
76. Language Programming Guide 3787 3213 301 1 1 What Is TAS 1 1 3 1 1 4 1 2 Homogeneous Heterogeneous File transfers can be either e Homogeneous OS 2200 host to OS 2200 host e Heterogeneous OS 2200 host to non OS 2200 host Local Remote Foreign Hosts When two or more computer systems are linked together in a TCP IP network each system is known as a host The system to which your terminal is connected is called the local host this must be an OS 2200 host All other hosts in the network are known as remote hosts OS 2200 or non OS 2200 Any remote host that is not an OS 2200 is called a foreign host 3787 3213 301 What Is the File Transfer Facility 1 2 What Is the File Transfer Facility The file transfer facility provides the ability to move files on the same system and between systems in a TCP IP network The TCP IP protocol for file transfer processing is called the File Transfer Protocol FTP Unisys software is based on the FTP standard It allows an OS 2200 host in a TCP IP network to communicate in either a homogeneous or a heterogeneous environment 1 2 1 Types of File Transfers You can process a file on e The same host to which you are attached local host e A different OS 2200 host in your network remote host You can transfer a file e Within a local host e From the local host to a remote host e From a remote host to the local host e Between remote OS 2200 hosts You
77. N aioe Sule Changing to the Parent Directory Using the CDUP Command Changing the Current Working Directory Using the CWD Command Deleting a File on a Local Host Using the DEALLOCATE Command Deleting a File on a Remote Host Using the DEALLOCATE Command Deregistering a Single File 6 cee Deregistering All Filenames ow eae Listing Available Functions on a Local Host Using FHELP Listing Available Functions on a Remote Host Using FHELP Registering a Filename ow eens Registering Multiple Filenames n nnana anaana Transferring Information Using the FSITE Command Saved Status Re uest ooccceirreiere ua ee oe le Creating a Directory on a Remote Foreign Host Using the MKD Command Printing the Name of the Current Directory Using the PWD Command Removing a Directory Using the RMD Command Renaming a File Using the RENAME Command Restarting a File Transfer within a Local Host Using the RESUME COMMANG Sesi ieee Deia e et ER an ei al Restarting a File Transfer from a Local to a Remote Host Using the RESUME Command sexs ce eck A mee th Ben we wah gid meted atte A LS Restarting a File Transfer from a Remote to a Local Host Using the RESUME Command erg 32 cewek Eai See nods thts ot Aelge 8 oF dene 3 68 3 68 3 71 3 81 3 83 3 84 3 86 3 88 3 89 3 89 3 90 4 1 4 3 4 3 4 5 4 5 4 6 4 6 4 6 4 10 4 11 4 12 3787 3213
78. Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 3 14 2 Incoming File Transfer Overview When a file is transferred to the 2200 as a result of a PUT command from a remote FTP client TAS converts the incoming file name to a file id and checks to see if the incoming file id matches a previously registered file id If a match is found the run stream associated with the registered file id is executed Add or Start 3 46 3787 3213 301 Registering a File for Event Notification REGISTER Screen Run Stream Selection To determine which run stream to initiate a comparison is made between the incoming file id and every registered file id in the registered list to determine the best match In this comparison a wild card indicator in the registered file id always matches its corresponding character in the incoming file id Consequently more than one match may be found An algorithm is used to determine the best match It assumes that a match with a wild card indicator is not as good as a match with a character All characters of a registered file id are compared against the incoming file id If there is a mismatch a new compare is started using the next registered file id If there is no mismatch a comparison value is generated After all registered file ids are compared the registered file id with the highest comparison value is determined to be
79. ORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 FGBEARANCE LEVEL clearance level ACCOUNT Yemote account info 1 remote account info 2 TYPE SYMBOL TCI ALL OMNIBUS SDF source Tow TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POST TION REPLACE ADD CHECKPOINT file name 3 uane apa integer SITEINFO information Keyword Parameters Refer to the TRANSFER command for a description of the keyword parameters For more information refer to e Methods of Transferring Files in 1 3 for a discussion of the differences between the GET FGET and PUT FPUT commands and the TRANSFER command e Subsection 5 20 Transferring a File for more information about file transfers keeping in mind that while using FPUT you are only transferring in one direction and that a session is open between the two hosts 3787 3213 301 5 19 Registering a Filename FREGISTER Command 5 10 Registering a Filename FREGISTER Command Use the FREGISTER command to register a filename for TAS event notification When a filename is registered TAS starts a user defined runstream when the registered filename is received You can e Register a single filename or a range of filenames e Use a wildcard character e Specify start options for the user defined runstream e Specify whether to START or ADD the runstre
80. PORT PASV MODE TYPE STRU information HELP file action ALLO REST STOR RETR APPE DELE ABOR miscellaneous NOOP F4 Return To Menu lt gt F5 Return To Command lt gt Fl0 more lt gt Me ee Example 3 8 Response to Listing Available Functions on a Local Host Using the FHELP Screen Note the use of the following fields at the bottom of the response screen 3787 3213 301 3 27 Getting Help FHELP Screen F4 Return To Menu lt gt Displays the Main Menu F5 Return To Command lt gt Displays the FHELP screen 3 7 2 Listing Available Functions on a Remote Host Procedure To list functions for a remote host 1 Display the FHELP screen from the MAIN MENU or from any other command screen 2 Inthe Host field enter the identifier of the remote host for which you want a list of available functions 3 Transmit the screen The file transfer facility displays the FHELP information Example Example 3 9 shows how to list the available functions on a remote host Ae FTP 6R1 FHELP 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host 6 3 0 3 Accept Data lt gt E 4 Example 3 9 Listing Available Functions on a Remote Host Using the FHELP Screen Example 3 10 shows the response to using the FHELP screen for a remote host 3 28 3787 3213 301 Getting Help FHELP Screen eet a aa ET a aa CC FTP
81. Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Project 1 Source 2 Dest Siteinfo Accept Data lt gt S Example 2 8 Accessing Field Help When you transmit the file transfer facility displays an explanation of the field at the bottom of the screen Example 2 9 shows the help available for the Checkpoint mark field on the TRANSFER screen 3787 3213 301 2 13 Using On Line Help for Screens PO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Om _ Sdf __ Tow Max Record Size Translate Transparent Ascii _ Ebcdic _ L36 Mode STREAM Block _ Compressed _ Position REPLACE _ Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Project 1 Source 2 Dest Siteinfo Accept Data lt gt The parameter CHECKPOINT MARK specifies the number of tracks to be transferred before a checkpoint marker will be written This parameter is an integer value This parameter is optional and can only be used when MODE BLOCK or MODE COMPRESSED The default value is 250 Nelly Example 2 9 Field Help Response After you transmit to request field help the question mark disappear
82. RANSFER 97 08 30 Fl Help lt gt F2 Refresh lt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type ALL ATTENTION THE COMPUTER WILL BE SHUT DOWN AT 12 00 P M Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block Compressed Position REPLACE Add Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Leve Account Project 1 Source 2 Dest Siteinfo Accept Data lt gt NG _______i iiii_i_i_ii_wiwiz_2 E_ LLIN Example 2 1 Clearing a Terminal Broadcast or Terminal Message When you transmit the file transfer facility displays a blank TRANSFER command screen for you to fill in Using the Command Section Enter the information you need to describe a file transfer command in the command section Types of Fields The command section contains three types of fields Input fields The input fields supply a field name and a blank line in which you enter the corresponding information Example Source Host Choice fields Choice fields provide options from which you can choose information such as file types data types modes and structures Example Structure FILE __ Record __ The Accept Data field This field processes a command screen Example Accept Data lt gt 3787 3213 301 2 5 Using the Menu Interface Entering Informat
83. SERID remote user id 1 remote user id 2 EE EARANCE LEVEL clearance level 1 clearance level 5 ACCOUNT Temote account info 1 remote account info 2 See Table 5 16 for information about parameter values If you want to include additional file transfer information for example defining the file type see Including More Specific Information about a File Transfer later in this section Example Example 5 26 shows how to transfer a file from a remote to a local host In this example for the remote source host we specify a e Password e User id e Account information In the example we also include an ampersand amp at the end of the first line to indicate the command continues on the next line gt C gt TRAN FROM 4 3 0 3 SDFFILE TO SDFILE PASS BNK amp gt C amp gt USERID SITFJB ACCO 696382860010 DDN gt END COMMAND Example 5 26 Transferring a File Remote to Local Using the TRANSFER Command 5 20 4 Transferring a File or Element between Remote Hosts Function Use this format to transfer a file or element between remote hosts Format TRANSFER FROM host id file name 1 e lement name 1 TO host id file name 2 e ement name 2 PASSWORD remote password 1 remote password 2 USERID remote user id 1 remote user id 2 FSREARANCE LEVEL clearance level 1 clearance level 5 ACCOUNT Temote account i nfo tl remote account info 2 3787 3213 301 5 57 Transferr
84. Specifying a Restart Point for File Transfer Recovery later in this section If you omit the checkpointid the file transfer resumes at the last checkpointid listed in the checkpoint file From file password The password you specified in the Source 1 Password field on the TRANSFER or GET screen when you transferred the file Use 1 to 18 alphanumeric characters This field is required when the file resides on either a e Remote host e Local host and the file has read write keys Clearance Level The clearance level associated with the original file Enter a number between 0 and 64 To file password The password you specified in the destination 2 Password field on the TRANSFER or PUT screen when you transferred the file Use 1 to 18 alphanumeric characters This field is required when the file resides on either a e Remote host e Local host and the file has read write keys Clearance Level The clearance level associated with the destination file name Enter a number between 0 and 64 3 17 1 Restarting a File Transfer within a Local Host Procedure To restart a file transfer within a local host 1 Display the RESUME screen from the MAIN MENU or from any other command screen 3 62 3787 3213 301 Restarting a File Transfer RESUME Screen 2 Inthe Checkpoint file name field enter the name of the checkpoint file you specified on the TRANSFER screen 3 Inthe From file password field enter the password you
85. TP1310 FTP1320 FTP1330 FTP1400 FTP1410 FTP1420 FTP1430 FTP1440 FTP1500 FTP1510 FTP1520 FTP1530 The FTP worker activity was unable to sign onto the MOP Please report the problem to your system administrator or contact your Unisys representative A message was received by SPI QUIT after a CLOSE was performed Please report the problem to your system administrator or contact your Unisys representative File Transfer Process worker activity timed out waiting for a command from the remote host The conversation with this host will be closed This condition does not affect the FTP monitor or processing with other remote hosts File Transfer Process worker activity received an abort indication from the remote host The conversation has been aborted File Transfer Process worker activity received an abort indication when sending a message The conversation has been aborted There are insufficient DDP 1100 resources available to service your request Please try again later There is currently not enough memory for FTP to execute the current command Please try again later File Transfer Process internal error occurred allocating internal table space to service your request Please report the problem to your system administrator or contact your Unisys representative File Transfer Process internal error occurred at location nn while allocating buffer space to service your request Please report the probl
86. Table 5 3 CWD Command Keyword Parameter Descriptions cont PASSWORD remote password The password as required by the foreign host Use 1 to 18 alphanumeric characters ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 3 shows how to change the current working directory The full pathname is not required because D1 is a subdirectory under the same parent directory as the current directory gt C gt CWD D1 FTP 257 Command processing successfully completed Example 5 3 Changing the Current Working Directory Using the CWD Command 3787 3213 301 5 7 Deleting a File DEALLOCATE Command 5 5 Deleting a File DEALLOCATE Command 5 8 Use the DEALLOCATE command to delete a file on either a e Local host e Remote host When you delete a file you free space on a host for other users You delete one file each time you transmit this command Notes 1 You cannot use the DEALLOCATE command to delete a file element 2 When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session If you specify a host id any existing session is closed and a new session is opened with the specified host Command Format DEALLOCATE FILE host id file name 1 PASSWORD remote password 2 USERID remote user id ERREARANCE
87. This must be a valid OS 2200 filename and must include at least a qualifier and file name This is a required field OPTIONS start options The options used to start the user defined runstream The valid start options are B C E to L M N P R to U and W to Z The X option is supported if the user has sufficient privileges This field is optional WILD wild character This indicates which character in the FILENAME parameter should be treated as a wild card when TAS matches an incoming file name with a registered one The value must be alphabetic or numeric Use only one character ONE_TIME_REG Deregisters the filename when a transfer is received that matches the filename that was registered Does not deregister the filename after a transfer is received that matches the filename that was registered The default is NO continued 3787 3213 301 5 21 Registering a Filename FREGISTER Command Table 5 7 FREGISTER Command Keyword Parameter Descriptions cont SAVE_STATUS YES Saves the filename and file transfer status until a Status Request command is received NO Does not save the file name or file transfer status The default is NO CONTROL control value This is an octal value which TAS enters in the SETC parameter of the START ECL statement it executes for the even notification runstream This is a 1 to 4 digit field with a leading O and no digit greater than 7 for example 0235 This field is optional
88. UNISYS OS 2200 TCP IP Application ervices ile ranster User Guide Copyright 1997 Unisys Corporation All rights reserved Unisys is a registered trademark of Unisys Corporation Level 6R1 September 1997 Printed in U S America Priced Item 3787 3213 301 The names places and or events used in this publication are not intended to correspond to any individual group or association existing living or otherwise Any similarity or likeness of the names places and or events with the names of any individual living or otherwise or that of any group or association is purely coincidental and unintentional NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THE DOCUMENT Any product and related material disclosed herein are only furnished pursuant and subject to the terms and conditions of a duly executed Program Product License or Agreement to purchase or lease equipment The only warranties made by Unisys if any with respect to the products described in this document are set forth in such License or Agreement Unisys cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material including direct indirect special or consequential damages You should be very careful to ensure that the use of this information and or software material complies with the laws rules and regulations of the jurisdictions with respect to which it is used The information conta
89. UNT 6941XYZ PASSWORD SNS Example 4 7 Using Keywords and Positional Notation to Enter a Command Using More Than One Line to Enter a Command When a command requires more than one line use an ampersand amp to continue the command on the next line Use the ampersand after the last parameter specification on a line do not insert an ampersand in the middle of a parameter specification Example 4 8 shows how to use more than one line to enter a command When you transmit the first line the continuation start of entry symbol C amp appears for you to enter the next line of the command For example gt C gt TRANSFER UCLA SDFFILE SD 01 SDFFILE ACCOUNT 6941XYZ PASSWORD SNS amp gt C amp gt USER SITFJB BBMET1 Example 4 8 Using More Than One Line to Enter a Command 46 3787 3213 301 Using the Command Interface 4 2 5 4 2 6 4 2 7 Transmitting a Command Transmit each command that you enter When you transmit a command the file transfer facility displays the following message TAS 6R1 Because the file transfer facility operates in an open system you can mix IPF 1100 commands with file transfer commands Command Processing When you transmit a file transfer command the local host software analyzes the command for correct syntax If no errors occur the local host either e Transmits the command to the hosts you specify in your command e Processes the command when you do not specify a r
90. Userid Specifies a userid to access the directory on the remote host if required Use 1 to 12 alphanumeric characters Password The password required to access the directory on the remote host This parameter may be optional depending on the requirements of the remote host i Use 1 to 18 alphanumeric characters Account Account number to access the directory on the remote host if required Use 1 to 12 characters Example Example 3 15 shows the response screen when you request the name of the current working directory FTP 6R1 PRINT WORKING DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Userid Password Account Accept Data lt gt FTP 257 Command processing successfully completed src tas d1 is current directory Ph eee Example 3 15 Displaying the Current Directory Name 3 42 3787 3213 301 Sending a File During a Session PUT Screen 3 13 Sending a File During a Session PUT Screen Function Use the PUT screen to transfer a file from your local host to a remote host during a session Before using the PUT screen use the LOGIN screen to open a session Refer to e Methods of Transferring Files in 1 3 for a discussion of the differences between the GET and PUT commands and the TRANSFER command e 3 19 Transferring a File for more information about file transfers keeping in mind that while using PUT you are
91. WD Command 5 4 Changing the Working Directory on a Remote Host CWD Command Use the CWD command to change the working directory on a remote foreign host If you specify a host id any existing session is closed and a new session is opened Note When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format CWD DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info Keyword Parameters Table 5 3 describes the keyword parameters for the CWD command Table 5 3 CWD Command Keyword Parameter Descriptions DIRECTORY remote pathname The name of the path to be changed on the remote host Use 1 to 132 alphanumeric characters This parameter is required The identifier of the host where the directory you want to change is located Use 1 to 255 alphanumeric characters If you omit the host id the host to which you are currently logged in is used Specify a hostid if a session is not currently active or if you want to close the current session and open a session with another host For more information about specifying host ids see Section 1 USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters continued 5 6 3787 3213 301 Changing the Working Directory on a Remote Host CWD Command
92. ace or replace data in the receiving file e Define transmission data e Identify when to take a checkpoint mark e Define data structure in the transmission file e Create a checkpoint file e Specify site information requested by a foreign host The field values you specify on the TRANSFER screen depend on the e Type of file you transfer For example you can transfer ASCII data EBCDIC data Binary data An SDF file A program file An element of a program file e Types of hosts involved in the transfer For example you can transfer Toor from an OS 2200 host Toor from a non OS 2200 host e Purpose of the transfer 3787 3213 301 Transferring a File TRANSFER Screen For example you can transfer a file to a destination host for Temporary storage Use or processing To help you determine which values to specify on the TRANSFER screen see File Transfer Guidelines later in this section Screen Figure 3 18 shows the TRANSFER screen FO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Omm _ Sdf _ Iow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Proje
93. acility displays the next part of the message At the end of the message series you receive the following message This is the end of the message series Transmit to repeat the series The message remains at the bottom of the screen however you can continue to enter data 3787 3213 301 2 15 Section 3 Using the Menu Interface 3 1 File Transfer Command Screens The following command screens are described in this section in alphabetical order e ALLOCATE e CHANGE TO PARENT DIRECTORY e CHANGE WORKING DIRECTORY e DEALLOCATE e DREGISTER e FHELP e FSITE GET e LOGIN e MAKE DIRECTORY e PRINT WORKING DIRECTORY e PUT e REGISTER e REMOVE DIRECTORY e RENAME e RESUME e STATUS REQUEST e TRANSFER There is no screen for the CLOSE command Instead you can select close from the Main Menu or enter cl on the command line of any screen The close command ends a session between two hosts If you need help displaying a command screen see 2 2 3787 3213 301 3 1 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Screen 3 2 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Screen Function Use the ALLOCATE screen to reserve file storage space on a remote foreign host if required by that host If you enter a host name any existing session is closed and a new session is opened with the specified host Note Ifa remote host does not implement the ALLOCATE command
94. after it is received You can specify that the filename and file transfer status be saved waiting for a user to retrieve this information using the Status Request command 3 14 1 Converting a File Name to a File ID TAS separates the submitted file name into seven parts to create the file id These are Part Length Qualifier 1 12 chars filename 1 12 chars f cycle 0 3 chars read key 0 6 chars 3787 3213 301 3 45 Registering a File for Event Notification REGISTER Screen Part Length write key 0 6 chars element name 0 12 chars version 0 12 chars If the information submitted for a part is less than the maximum length for that part TAS adds trailing blanks to expand the part to its maximum length If a wild card character is provided as part of the Register command TAS replaces all instances of that wild card character found in the file name with a wild card indicator semicolon If the wild card character is found as the last character in one of the parts any remaining characters for that part will be stored as wild card indicators Example 1 The following file name aaaaaaa BBBBBB CC is converted to file id Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character AAAAAAA BBBBBB CC Example 2 The following file name with Z indicated as a wild card ABZFGZ BBZ TT is converted to file id Qualifier
95. am e Save file transfer completion status and the filename so that this information can be retrieved e Specify that the filename be deregistered upon receipt Command Format FREGISTER USERID application id FILE file name RUN runstream OPTIONS start option WILD wi1d card character ONE TIME_REG YES NO SAVE_STATUS YES NO CONTROL CONTROL VALUE INITIATE ADD START You can omit the keyword portion USERID FILE and RUN when you use positional notation Include the parameter values in order Keyword Parameters Table 5 7 describes the keyword parameters for the FREGISTER command Table 5 7 FREGISTER Command Keyword Parameter Descriptions USERID application id This identifies the owner of the event notification record It is used by TAS to associate registered file names with an owner to be used when deregistering all file names or when obtaining event notification status Use 1 to 12 alphabetic and or numeric characters This is a required field continued 5 20 3787 3213 301 Registering a Filename FREGISTER Command Table 5 7 FREGISTER Command Keyword Parameter Descriptions cont FILE filename This is the name of the file you want to register This must be a valid OS 2200 filename and must include at least a qualifier and file name This is a required field RUN runstream This is the name of the user defined runstream that will be executed when this registered file is received
96. an OS 2200 host with TAS installed Table 3 18 Sample File Transfer Situations Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element Program file OS 2200 to Use on destination host STRUCTURE FILE OS 2200 TRANSLATE TRANSPARENT SDF data file OS 2200 to Use on destination host STRUCTURE FILE containing ASCII OS 2200 TRANSLATE TRANSPARENT characters Print file OS 2200 to Print on destination host STRUCTURE FILE OS 2200 TRANSLATE TRANSPARENT continued 3787 3213 301 3 93 Transferring a File TRANSFER Screen Table 3 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element Absolute element OS 2200 to Use on destination host 1 Copy the absolute element to an OS 2200 empty program am file on your local host 2 Transfer that file to the destination host using STRUCTURE FILE TRANSLATE TRANSPARENT ASCII symbolic OS 2200 to Add to existing program STRUCTURE RECORD element OS 2200 file on destination host TRANSLATE ASCII POSITION ADD Omnibus element OS 2200 to Use on destination host STRUCTURE RECORD OS 2200 TRANSLATE TRANSPARENT TYPE OMNIBUS ASCII file Non OS 2200 to Temporary storage to STRUCTURE RECORD OS 2200 be returned to foreign TRANSLATE ASCIl host When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host th
97. aracters continued 3787 3213 301 5 35 Removing a Directory on a Remote Host RMD Command Table 5 13 Remove Directory Command Keyword Parameter Descriptions cont PASSWORD remote password The password as required by the foreign host Use 1 to 18 alphanumeric characters ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 16 shows how to remove a directory The example then verifies that the directory was removed by attempting to change to the directory that was removed C gt RMD D2 gt TAS 5R3Q5 0617 1 Command Processing Completed Successfully Example 5 16 Removing a Directory Using the RMD Command 5 36 3787 3213 301 Renaming a File RENAME Command 5 18 Renaming a File RENAME Command Use the RENAME command to rename a file The file must exist on a remote foreign host If you specify a host id any existing session is closed and a new session is opened with the specified host Command Format RENAME HOST host id 1 FROM old file name 2 TO new file name 3 PASSWORD remote password USERID remote user id ACCOUNT remote account info You can omit the keyword portions HOST FROM TO and PASSWORD when you use positional notation Include the parameter values in this order Keyword Parameters Table 5 14 describes the keyword parameters for the RENAME comman
98. ations do not accept record structure STRUCTURE RECORD You may want to transfer a file to a host for temporary storage That is the file is not used on the destination host only stored and returned later to the original host Specify STRUCTURE FILE and TRANSLATE TRANSPARENT If TAS is acting as the server for the transfer the user on the remote host should specify whatever parameters that system requires to cause the FTP protocol commands STRU F and TYPE I to be sent 3787 3213 301 Transferring a File TRANSFER Screen Specify a checkpoint mark only when You specify a checkpoint file name The sending file is on your local host Do not specify a checkpoint file name when you specify MODE STREAM Guidelines for Transfers between OS 2200 Hosts When you transfer a file between OS 2200 hosts follow these guidelines Use STRUCTURE FILE for the fastest transfer When using the Position field Do not replace an element with a file Add only elements to a program file When you add an element you must specify an element name in both the source file name field and the destination file name field Do not add data to an element Do not add data to an SDF file Do not specify SDF or IOW for TYPE Do not specify MODE COMPRESSED Guidelines for Transfers Involving Foreign Hosts When you transfer a file involving a foreign host follow these guidelines Many foreign hosts only support file s
99. bit binary data in 9 bit bytes the 9th bit of each byte is meaningless and is not transferred you have two options o Ifthe data resides in an SDF file or program element you can specify TRANSLATE TRANSPARENT STRUCTURE FILE and TYPE SDF In this case TAS does not transfer any file control information and sends FTP protocol TYPE I o Ifthe data resides in a non SDF file specify TRANSLATE TRANSPARENT STRUCTURE FILE and TYPE IOW TAS sends FTP protocol TYPE I When you specify TRANSLATE EBCDIC TAS acting as the initiator will convert the data from ASCII to EBCDIC when your local host is the source host and from EBCDIC to ASCII when your local host is the destination host TAS will do this conversion when acting as the server if TYPE E FTP protocol is received Use MODE COMPRESSED with discretion as it requires additional TAS processing Use only this mode when the file you transfer contains large numbers of replicated characters for example ASCII spaces or binary zeros Also the file transfer is rejected when the remote host does not support compression FTP protocol MODE c 3787 3213 301 Transferring a File TRANSFER Command Acceptable Parameter Combinations Table 5 17 shows acceptable combinations for specifying the Type Translate and Structure parameters in the TRANSFER command In the table the first column indicates the type of file or element you want to transfer The remaining columns indicate
100. ble 5 6 describes the keyword parameters for the FHELP command Table 5 6 FHELP Command Keyword Parameter Description HOST hostid The host id is the identifier of the host where the file resides If no session is established e Omitting the hostid gives help for the local host Specifying a host id causes a connection to be opened the help information obtained and the connection closed If a session is established this parameter is not needed If you enter a host id the session closes and a new session opens to the specified host When the command completes the session closes Use 1 to 132 alphanumeric characters For more information about specifying host ids see Section 1 5 8 1 Listing Available Functions on a Local Host 5 16 3787 3213 301 Getting Help FHELP Command Function Use this format to list available functions on a local host Format FHELP Example Example 5 8 shows how to list available functions on a local host E S gt C gt FHELP TAS 6R1 0603 1 The Unisys TAS File Transfer processor provides a reliable and efficient means of sharing and transferring files between hosts in a TCP IP network This FTP implementation includes these functionalities and protocols login USER PASS ACCT logout QUIT REIN transfer PORT PASV MODE TYPE STRU information HELP file action ALLO REST STOR RETR APPE DELE ABOR miscellaneous NOOP The F
101. clearance level ACCOUNT Yemote account info T remo e account info 2 TYPE SYMBOL TCI ALL OMNIBUS SDF souRce Tow TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POST TION REPLACE ADD CHECKPOINT file name 3 uane apa integer SITEINFO information Keyword Parameters Refer to the TRANSFER command for a description of the keyword parameters For more information refer to e Methods of Transferring Files in 1 3 for a discussion of the differences between the GET FGET and PUT FPUT commands and the TRANSFER command e Susection 5 20 Transferring a File for more information about file transfers keeping in mind that while using FGET you are only transferring in one direction and that a session is open between the two hosts 3787 3213 301 5 15 Getting Help FHELP Command 5 8 Getting Help FHELP Command FTP protocol implementations can include different functionality For example many implementations do not accept record structure STRUCTURE RECORD Use the FHELP screen to list the available file transfer functions on a e Local host e Remote host You can also use the FHELP command to check the connection between the local host and another host in the network Command Format FHELP HOST host id 1 You can omit the keyword portion HOST when you use positional notation Keyword Parameters Ta
102. count Project 1 Source y 2 Dest Siteinfo Accept Data lt gt The TRANSFER command provides you with the capability to store a file or element on a remote host retrieve a file or element from a remote host transfer a file or element between two remote hosts F10 MORE lt i gt S y Example 2 7 Command Help Screen Note that the last line on the screen displays the following field F10 MORE lt gt This field indicates that there is more help available through additional messages Continue to transmit the screen from this position or use the F10 function key to display the additional messages When you reach the end of the message series you receive the following message This is the end of the message series Transmit to repeat the series Accessing Field Help To access field help 1 Move the cursor to the first space of the field for which you want help 2 Enter a question mark 3 Transmit the screen Example 2 8 shows how to get help for the Checkpoint mark field on the TRANSFER screen 3787 3213 301 Using On Line Help for Screens POO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Omm _ Sdf _ Iow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _
103. creen enter all of the required information for the particular type of transfer you want to perform See previous subsections Enter any or all of the following additional information 1 Inthe Type field enter the type of file or element you want to transfer if you do not want to use the default SYM 2 Inthe Max Record Size field specify the largest number of bytes to be passed as a message to DDP PPC when the Structure field is specified as Record The default 3 968 bytes is strongly recommended 3 Inthe Translate field identify how data is represented in the transmission file if you do not want to use the default Transparent 4 Inthe Position field indicate that you want to add to an existing file if you do not want to use the default REPLACE 5 Inthe Mode field indicate how you want to transmit data if you do not want to use the default STREAM 6 Inthe Checkpoint mark field specify how often you want checkpoint markers written in the checkpoint file if you do not want to use the default every 250 tracks 7 Inthe Structure field indicate how you want to transmit data if you do not want to use the default FILE 3787 3213 301 3 87 Transferring a File TRANSFER Screen 8 Inthe Checkpoint file name field enter the name of a checkpoint file You must enter a checkpoint file name now to be able to later use the RESUME screen to recover a file transfer 9 In the Siteinfo field specify the information req
104. creen to get the saved filename and file completion status from the file transfer program if this information has been requested using a Register command You can deregister the filename entry that is associated with this saved status Screen Figure 3 17 shows the STATUS REQUEST screen Poo S FTP 6R1 STATUS REQUEST 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID De Register Entry yes NO __ Filename Received File Status Accept Data lt gt sooo oo Figure 3 17 STATUS REQUEST Screen Screen Field Descriptions Table 3 15 describes the fields in the STATUS REQUEST screen Table 3 15 STATUS REQUEST Screen Fields a Application ID This identifies the owner of the event notification record Use 1 to 12 alphanumeric characters a to z A to Z and 0 to 9 This is a required field continued 3787 3213 301 3 69 Getting Filename and File Registration Status STATUS REQUEST Screen Table 3 15 STATUS REQUEST Screen Fields cont ee De Register Entry Deregisters the filename record that matches this saved record The last filename cannot be deregistered if there is Saved status NO Do not deregister any filename records The default is NO Filename Received This information is supplied by TAS File Status This information is supplied by TAS Procedure To get the filename and file status
105. ct Source Dest Re cosy Siteinfo Accept Data lt gt Ne Figure 3 18 TRANSFER Screen Screen Field Descriptions Table 3 16 describes the fields in the TRANSFER screen For additional help using the Type Translate and Structure fields see Table 3 17 Table 3 16 TRANSFER Screen Fields ee Source Host The name of the host where the file or element resides Use 1 to 24 alphanumeric characters The default is the local host For more information about specifying host ids see Section 1 continued 3787 3213 301 3 73 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont ee Source File Name The name of the file or element you want to transfer This must be a valid file name for the host on which the file resides This field is required For more information about specifying file names see Section 1 Destination Host The name of the host to which you are transferring the file or element Use 1 to 24 alphanumeric characters For more information about specifying host ids see Section 1 Destination File Name The name of the file or element to which you are copying This must be a valid file name for the host on which the file resides This field is required For more information about specifying file names see Section 1 Subfield Description SYM Transfers a symbolic element in the sending file to the receiving file at the local or a remote hos
106. d Table 5 14 RENAME Command Keyword Parameter Descriptions HOST hostid The identifier of the foreign host Use 1 to 132 alphanumeric characters For more information about specifying host ids see Section 1 FROM from file name The name of the file you want to rename This must be a valid file name for the system on which the file resides This parameter is required TO new file name The new file name for the file you specify for the FROM parameter This must be a valid file name for the system on which the file resides This parameter is required For more information about specifying file names see Section 1 PASSWORD remote password The password as required by the foreign host Use 1 to 18 alphanumeric characters continued 3787 3213 301 5 37 Renaming a File RENAME Command Table 5 14 RENAME Command Keyword Parameter Descriptions cont USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters ACCOUNT remote account info Use 1 to 25 alphanumeric characters When you include a space enclose the account information in double quotes Example Example 5 17 shows how to rename the file SDFFILE1 In this example we omit the keywords HOST FILE and TO because we are using positional notation gt C gt RENA SD 01 SDFFILE1 SDFFILE2 USER SITFJB gt END COMMAND Example 5 17 Renaming a File Using the RENAME Command 5 38
107. d is required when the file resides on the local host and the file has read write keys Clearance Level The clearance level as required by the remote host Enter a number between 0 and 63 Account The number as required by the remote host leone Use 1 to 12 alphanumeric characters Project The project identifier as required by the remote host Use 1 to 12 alphanumeric characters 3 5 1 Deleting a File on a Local Host Procedure To delete a file on a local host 1 Display the DEALLOCATE screen from the MAIN MENU or from any other command screen You must not be logged in to a remote host 2 Inthe File name field enter the name of the file you want to delete 3 12 3787 3213 301 Deleting a File DEALLOCATE Screen 3 4 If the file you want to delete has read write keys enter a password in the Password field Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 4 for additional information about field values Example Example 3 4 shows how to delete a file on a local host OO e n a FTP 6R1 DEALLOCATE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt File name OMNFILE Host Userid Password Clearance Level Account Project Accept Data lt gt FTP5095 Command completed successfully Example 3 4 Deleting a File on a Local Host Using the D
108. dditional information on checkpointing see Section 1 Example Example 5 22 shows the contents of a sample checkpoint file eee es FROM FILEA TO SD 01 FILEB USER DDNJM ACC0 696382860010 POSI R TYPE S TRAN T MODE B STRU F MAXR 3968 CHEC CHK MARK 10 MARK 640 0 640 0 16 17 40 MARK 1280 0 1280 0 16 17 41 MARK 1920 0 1920 0 16 17 42 MARK 2560 0 2560 0 16 17 42 MARK 3200 0 3200 0 16 17 43 MARK 3840 0 3840 0 16 17 43 MARK 4480 0 4480 0 16 17 43 Example 5 22 Sample Checkpoint File Example 5 23 shows how to restart a file transfer by selecting 1920 from Example 5 22 as the restart checkpoint id In this example we specify a e Checkpoint id e Password for a remote source host 5 44 3787 3213 301 Restarting a File Transfer RESUME Command gt C gt RESU FILE CHK AT 1920 PASS LMB gt END COMMAND Example 5 23 Specifying a Restart Point Using the RESUME Command 3787 3213 301 5 45 Transferring a File TRANSFER Command 5 20 Transferring a File TRANSFER Command Use the TRANSFER command to transfer a copy of a file or element e Within a local host e From a local to a remote host e From a remote to a local host e Between remote hosts If a session is already open when a transfer command is entered any file transfer in progress completes and the session is closed The transfer is then made No session is open when the transfer is complete Optionally you can include
109. e CUR st OO FTP 6R1 CHANGE TO PARENT DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Userid Password Account Vee ees ey Her pe ot ears Accept Data lt gt FTP5095 Command completed successfully Dee ee 1 a 4 Se Tee Example 3 2 Changing to the Parent Directory 3787 3213 301 3 7 Changing the Working Directory CHANGE WORKING DIRECTORY Screen 3 4 Changing the Working Directory CHANGE 3 8 WORKING DIRECTORY Screen Function Use the CHANGE WORKING DIRECTORY screen to change the current working directory on a remote foreign host for file storage or file retrieval purposes If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 3 shows the CHANGE WORKING DIRECTORY screen eS FTP 6R1 CHANGE WORKING DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host To specified directory Userid Password Account Accept Data lt gt Te Figure 3 3 CHANGE WORKING DIRECTORY Screen Screen Field Descriptions Table 3 3 describes the fields in the CHANGE WORKING DIRECTORY screen 3787 3213 301 Changing the Working Directory CHANGE WORKING DIRECTORY Screen Table 3 3 CHANGE WORKING DIRECTORY Screen Fields es The identifier of the remote host where you wan
110. e project id Specify the account information for the source host FROM first followed by the account information for the destination host TO Enclose the account information in parentheses and separate the source host information from the destination host information with a comma When you specify account information for one host only the file transfer facility uses it to access the remote host or hosts The account number associated with your run is always used for processing on your local host SYMBOLIC Transfers a symbolic element in the sending file to the receiving file at the local or remote host The default is SYMBOLIC TYPE continued Transfers the entire file This is the fastest way to transfer a file Do not specify an element name with TYPE ALL To transfer an absolute or relocatable element first move it to a file by itself and then transfer that file TYPE continued OMNIBUS Transfers an omnibus element in the sending file to the receiving file at the local or remote host continued 5 50 3787 3213 301 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont TYPE continued SDF Transfers an SDF file or program element as 8 bit binary data the 9th bit of each byte is meaningless and ignored All file control information is also ignored not transferred This is useful when the data portion of the file or element is usable
111. e 2 2 PASSWORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 EE EARANCE LEVEL clearance level 7 ACCOUNT Temo e account info 1 remo e account info 2 LTYPE SYMBOLTCIALL OMNIBUS ISDF SOURCE TOW TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POST TION REPLACE ADD CHECKPOINT fi le name 3 MARK 250 integer SITEINFO information HOST host id 1 FROM file name 1 element name 1 1 TO file name 2 element name 2 2 PASSWORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 FSREARANCE LEVEL clearance level i ACCOUNT Yemote account info 1 remote account info 2 LTYPE SYMBOLIC ALL OMNIBUS ISDF SOURCE TOW TRANSLATE ASCII EBCDIC TRANSPARENT L36 MODE STREAM BLOCK COMPRESSED STRUCTURE FILE RECORD MAX RECORD SIZE 7168 integer POST TION REPLACE ADD CHECKPOINT fi le name 3 MARK 250 integer SITEINFO information USERID application id FILE file name RUN runstream OPTIONS start option WILD wi1d card character ONE TIME_REG YES NO CONTROL Tontrol value Pae STATUS YES NO INITIATE ADD ST RT HOST hostid 1 INFORMATION information 2 PASSWORD remote password USERID remote user id ACCOUNT remote account info USERID application id DREG ENTRY YES INO HOST host id PASSWORD remote password
112. e FTP protocol commands should be STRU R and TYPE A or STRU F and TYPE A Use the same procedure to transfer the file back to the foreign host Program file OS 2200 to Temporary storage to STRUCTURE FILE non OS 2200 be returned to local host TRANSLATE TRANSPARENT When the transfer is initiated by the foreign host the FTP protocol commands should be STRU F and TYPE I continued 3 94 3787 3213 301 Transferring a File TRANSFER Screen Table 3 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element ASCII data file OS 2200 to Use on destination host STRUCTURE RECORD non OS 2200 TRANSLATE ASCIl When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE A or STRU F and TYPE A ASCII symbolic OS 2200 to Use on destination host STRUCTURE RECORD element non OS 2200 TRANSLATE ASCII When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE ASCII When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE A or STRU F and TYPE A Binary file OS 2200 to Temporary storage to STRUCTURE FILE non OS 2200 be returned to local host TRANSLATE TRANSPARENT When the transfer is initiated by the foreign host the FTP
113. e Local Host Using the TRANSFER Srn rare ia tte tue wie tty iN De te Sue Ate hae hed tee Gata Be al ee Waban Sate wen As Transferring a File Local to Remote Using the TRANSFER Screen Transferring an Element Remote to Local Using the TRANSFER Screen Transferring a File between Remote Hosts Using the TRANSFER Screen Transferring an Omnibus Element within the Local Host Using the TRANSFER SGrEEM 2 atch heb bcd til cna tooth Ga the oe N Transferring a Symbolic Element from a Remote Host to the Local Host Using the TRANSFER Screen eee Transferring a File Containing EBCDIC Code from the Local Host to a Remote Host Using the TRANSFER Screen 00 0 0 000 Transferring a Local File to a Remote File as Sequential Records Starting the Command Interface 6 ee Requesting the END COMMAND Message 00 Suppressing the END COMMAND Message 0 4 Sample File Transfer Command 6 ne Using Keyword Syntax to Enter a Command 0 0005 Using Positional Notation to Enter a Command 4 Using Keywords and Positional Notation to Enter a Command Using More Than One Line to Enter a Command Accessing Help fora Command 0 00 cece ene Accessing Help fora Parameter 6 ene Accessing Help for an Error Message ononon ene Allocating a File on a Remote Foreign Host Using the ALLOCATE Command Lisas hom dae anes gees souk eA a
114. e sending file is on an OS 2200 host and the receiving file is on a non OS 2200 host e Specify the sending file name according to OS 2200 conventions e Specify the receiving file name according to the conventions of the receiving host There are some file transfer commands that are not supported by Unisys as a server If these commands are received from a non OS 2200 host they are refused These commands are ALLO NLST RNTO CDUP NOOP SITE CWD PWD SMNT LIST REIN STAT MKD RMD STOU RNFR SYST Specifying Host Identifiers Each host in a network has its own host identifier host id You use host ids when you perform the file transfer functions You must follow certain guidelines when you specify a host id Two formats are available to specify a host id e Internet physical address always valid e Logical host name valid only if implemented by your site administrator Using the Internet Physical Address Format 1 8 Use the following format to specify a host id using the internet physical address format nl n2 n3 n4 3787 3213 301 What Do I Need to Know to Use File Transfer Include the dashes The following is an example of a host id using the internet physical address format 4 3 0 1 Using the Logical Host Name Format Systems using logical host names must follow the following format rules for names These names e Can be up to 255 characters 24 on transfer e Can include alphanumerics as well as the minus s
115. e the cursor to the F1 Help lt gt field at the top of the screen and transmit Example 2 6 shows how to access command help for the TRANSFER command screen T FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Om _ Sdf _ Iow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Project 1 Source a 2 Dest Siteinfo B Accept Data lt gt NY Example 2 6 Accessing Command Help After you transmit the screen is redisplayed with a help message at the bottom Example 2 7 shows the first part of the on line help available for the TRANSFER command screen 3787 3213 301 2 11 Using On Line Help for Screens 2 3 4 2 12 POS FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SM _ AIT _ Om _ Sdf _ Iow_ Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE Record _ Checkpoint mark Checkpoint file name Userid Password Level Ac
116. e the following message END IPF 3787 3213 301 Using the Command Interface 4 2 Using the Command Interface 4 2 1 Setting the Command Complete Message Function Normally when you enter a command IPF 1100 displays the next start of entry symbol to indicate command processing is complete Optionally you can request IPF 1100 to display the following completion message to indicate command processing is complete END COMMAND Requesting Command Completion Messages Example 4 2 shows how to request display of the END COMMAND message gt C gt SET COMPLETIONS TRUE gt END COMMAND gt C gt Example 4 2 Requesting the END COMMAND Message Suppressing Command Completion Messages Example 4 3 shows how to suppress the END COMMAND message IPF 1100 responds with a start of entry symbol gt C gt SET COMPLETIONS FALSE gt C Example 4 3 Suppressing the END COMMAND Message 4 2 2 Command Conventions Table 4 1 explains the conventions we use to document the file transfer commands 3787 3213 301 4 3 Using the Command Interface Table 4 1 Command Conventions C common sample oeeo Uppercase FILE Indicates a command or parameter that you must enter exactly as shown Lowercase file name 1 Indicates a variable you must define and enter Italics RESUME Indicates an abbreviation you can use to enter a command or parameter AT checkpoint id Indicates an optional
117. ection to be opened the help obtained and the connection closed If a session is established this field is not needed If you enter a host id the session is closed and a new session is opened to the specified host When the command completes the session is closed For information about specifying host ids see Section 1 3 7 1 Listing Available Functions on a Local Host Procedure To list functions for a local host when you are not currently logged in to a remote host 1 Display the FHELP screen from the Main Menu or from any other command screen 2 Transmit the screen The file transfer facility displays the FHELP information Example Example 3 7 shows how to list available functions for a local host 3 26 3787 3213 301 Getting Help FHELP Screen FO TEE FTP 6R1 FHELP 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Accept Data lt gt a Example 3 7 Listing Available Functions for a Local Host Using the FHELP Screen Example 3 8 shows the response to using the FHELP screen for a local host Bee FTP 6R1 FHELP INFORMATION 97 08 30 The Unisys TAS File Transfer Protocol processor provides a reliable and efficient means of sharing and transferring files between hosts in a network This FTP implementation includes these functionalities and protocols login USER PASS ACCT logout QUIT REIN transfer
118. eee Starting and Ending a Session Exiting File Transfer 0 2 ee Using the Menu Interface Sections of a Command Screen Using the Header Section Using the Function Key Section Using the Command Section Using the Message Section Accessing Command Screens Accessing a Command Screen from the MAIN MENU pana i a i A Accessing a Command Screen from Another Command Screen 2 0 0 00000 ee Transmitting a Command Screen Using On Line Help for Screens Types of Help Available 0 Accessing General Help 000005 Accessing Command Screen Help Accessing Field Help ww ee ee eee Accessing Error Message Help Using the Menu Interface 3 1 3 2 3 3 3 4 3 5 3 0 1 See 3 6 3 6 1 3 6 2 File Transfer Command Screens Reserving Storage on a Remote Host for the Transferred File ALLOCATE Screen Changing to the Parent Directory CHANGE TO PARENT DIRECTORY Screen _ Changing the Working Directory CHANGE WORKING DIRECTORY Screen Deleting a File DEALLOCATE Screen Deleting a File on a Local Host Deleting a File on a Remote Host Deregistering a File DREGISTER Screen
119. eleting a File on a Remote Host Using the DEALLOCATE Screen 3787 3213 301 Deregistering a File DREGISTER Screen 3 6 Deregistering a File DREGISTER Screen Function Use the DREGISTER screen to deregister a file from event notification If event notification is in effect TAS starts a user defined runstream when the registered file name is received When a file is deregistered no runstream is started when the file is received If the deregister function attempts to deregister the last file registered with an application id and there is saved status information for that application id then the file is not deregistered until you retrieve the status information using the ddn_stat function If DeRegister ALL YES and no file name is entered then all files associated with the application id will be deregistered regardless of any saved status information Screen Figure 3 5 shows the DREGISTER screen lt a FTP 6R1 DREGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID File name Wild Card Character De Register All yes NO Accept Data lt gt Se o ee Figure 3 5 DREGISTER Screen Screen Field Descriptions Table 3 5 describes the fields in the DREGISTER screen Table 3 5 DREGISTER Screen Fields A Application ID This identifies the owner of the Event Notification record Use 1 to 12 alphanumeric characters a
120. em to your system administrator or contact your Unisys representative File Transfer Process internal error occurred at location nn while deallocating buffer space Please report the problem to your system administrator or contact your Unisys representative The following MCP message was received message text MOP error number nn received on a SIGNON request Please report the problem to your system administrator or contact your Unisys representative The following MCP message was received on a SIGNOFF request message text MCP internal error number nn received on an OPEN request Please report the problem to your system administrator or contact your Unisys representative 3787 3213 301 TAS FTPMSG Error Messages File FTP1540 FTP1550 FTP1560 FTP1570 FTP1580 FTP1710 FTP1720 3787 3213 301 The following MCP message was received on a RECEIVE request message text The following MCP message was received on a SEND by SPI CONTROL or QUIT message host The following MCP message was received on a CLOSE by SPI QUIT message text The following MCP message was received on an ABORT request message test MCP error number nn received on a PASSOFF request Please report the problem to your system administrator or contact your Unisys representative MCP internal error number nn received by the FTP user run on a PASSOFF request Please report the problem to your system administrator or contact your Unisys
121. emote host The processing of a file transfer command can involve extensive communications traffic and can require a few seconds to complete Several minutes for a large file When the local and remote hosts finish processing a command you receive a completion message to indicate that the terminal is ready for another command Summary of Commands and Parameters The following is a summary of file transfer commands and parameters A number after a parameter indicates a positional parameter Italics indicate allowable abbreviations for commands and parameters If you need help with command conventions see Table 4 1 ALLOCATE BYTES integer 1 RECORDS integer 2 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info CDUP HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info CWD DIRECTORY pathname 1 HOST host id USERID remote user id PASSWORD remote password ACCOUNT remote account info DEALLOCATE FILE host id file name 1 PASSWORD remote password 2 USERID remote user id EGREARANCE LEVEL clearance level ACCOUNT re mote account i nfo DREGISTER USERID application id FILE file name WILD wild card character DREG_ALL YES NO 3787 3213 301 4 7 Using the Command Interface FGET FHELP FPUT FREGISTER FSITE FSTATUS LOGIN LOGOUT MKD PWD RMD FROM file name 1 element name 1 1 TO file name 2 element nam
122. en tik os ytd te 3 84 3 19 5 Including More Specific Information about a File Transfer ree ty e e i a teat 3 86 3 19 6 File Transfer Guidelines 2 ee 3 90 Guidelines for All Types of Transfers 3 90 Guidelines for Transfers between OS 2200 HOSES arenose Bea bln Sate ie Mallee a bey 3 91 Guidelines for Transfers Involving Foreign Hosts 3 91 Acceptable Parameter Combinations 3 92 3 19 7 Sample File Transfer Situations 3 93 Section 4 Getting Started with the Command Interface 4 1 Starting and Ending 4 1 4 1 1 STAMING UPS soiaet a Ceesetacti te oie ee 4 1 4 1 2 Ending e erroa eee ea hha a pees 4 2 4 2 Using the Command Interface 4 3 4 2 1 Setting the Command Complete Message Function 4 3 Requesting Command Completion Messages 4 3 Suppressing Command Completion Messages 4 3 4 2 2 Command Conventions 05 4 3 4 2 3 Parts of a Command 2 eee 4 4 4 2 4 Entering a Command 45 4 5 Using Keyword Syntax 00 4 5 Using Positional Notation 4 5 Using a Combination of Keywords and Positional Notation 0 0 0 0 4 6 Using More Than One Line to Enter a Command 4 6 4 2 5 Transmitting a Command 4 7 4 2 6 Command Processing 005 4 7 4 2 7 Summary of Commands and Parameters 4 7 4 3 Using On Line Help for Commands
123. er a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 7 shows the FSITE screen FON FTP 6R1 FSITE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Information User id Password Account Accept Data lt gt Seea aa M Figure 3 7 FSITE Screen Screen Field Descriptions Table 3 7 describes the fields in the FSITE screen 3 30 3787 3213 301 Transferring Information Requested by a Foreign Host FSITE Screen Table 3 7 FSITE Screen Fields es The identifier of the foreign host Use 1 to 255 alphanumeric characters For information about specifying host ids see Section 1 Information The information to be sent to the foreign host You must include the FTP protocol as part of the information The following FTP protocol commands are the only ones that may be entered ALLO Reserve sufficient storage to accommodate the new file to be transferred CDUP Change the current working directory to the parent of the current working directory CWD Change the current directory to the specified directory MKD Make directory NOOP Specifies no action other that having the server send a reply PWD Print the current working directory RMD Remove directory SITE Provide services specific to the remote system SMNT Allow the user to mount a different file system data structure Use 1 to 1
124. er filenames that match a specified file name 1 5 6 Display the DEREGISTER screen from the MAIN MENU or from any other command screen In the Application ID field enter the name of the application In the File name field enter the name of the file to be deregistered In theWild Card Character field enter the wildcard character to be used to deregister a file In the De Register All field select the YES field Transmit TAS then displays a completion message at the bottom of the screen See Table 3 5 for additional information about field values 3 20 3787 3213 301 Deregistering a File DREGISTER Screen Example The registered files associated with application id AAA are File 1 bbc eef Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BBC EEF File 2 rrr adfgg Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character RRR ADFGG The registered files associated with application id BBG are File 1 abc def Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character ABC DEF File 2 uopt abc ggh Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456
125. ers ow eee 1 2 2 Types of Files and Elements 1 2 3 File Transfer User Interfaces 1 2 4 Overview of File Transfer Functions 1 3 What Do I Need to Know to Use File Transfer 1 3 1 Specifying File and Element Names OS 2200 Hosts eee OS 2200 and Non OS 2200 Hosts 1 3 2 Specifying Host Identifiers Using the Internet Physical Address Format Using the Logical Host Name Format When You Should Not Specify a Local Host id When You Should Specify a Remote Host id 1 3 3 Methods of Transferring Files Transferring Files using the TRANSFER Command eee Transferring Files using GET and PUT Commands 0 eee Using Other FTP Commands in an Open Session 1 3 4 Error Messages eee 1 3 5 Checkpointing 0 cece eee eee 3787 3213 301 Contents of Checkpoint File Results of an Unsuccessful File Transfer Results of a Successful File Transfer xvii 1 1 1 1 1 1 1 2 1 2 1 3 1 3 1 4 1 4 1 5 1 7 1 7 1 7 1 8 1 8 1 8 1 9 1 9 1 9 1 10 1 10 1 10 1 11 1 11 1 12 1 13 1 14 1 14 Contents Section 2 Section 3 Getting Started with the Menu Interface 2 1 2 1 1 2 1 2 2 1 3 2 2 2 2 1 2 2 2 2 2 3 2 3 2 3 1 2 3 2 2 3 3 2 3 4 2 3 5 Starting and Ending a Menu Interface Session Starting File Transfer 2 0
126. es to retrieve the file Omnibus element OS 2200 to Use on destination host STRUCTURE RECORD non OS 2200 TRANSLATE TRANSPARENT TYPE OMNIBUS When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE I EBCDIC data file Non OS 2200 to Use on destination host STRUCTURE RECORD OS 2200 TRANSLATE EBCDIC When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE EBCDIC When the transfer is initiated on the foreign host the FTP protocol commands should be STRU R and TYPE E or STRU F and TYPE E The data in the file will be converted by TAS from EBCDIC to ASCII character format continued 5 66 3787 3213 301 Transferring a File TRANSFER Command Table 5 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element Binary file of 8 bit OS 2200 to Possible use on TRANSLATE TRANSPARENT data non OS 2200 destination host TRANSLATE EBCDIC or When the data for the OS 2200 host comes from or goes to a file that you will access via ER IOWS specify TYPE IOW Non OS 2200 to When the data for the OS 2200 host OS 2200 comes from or goes to an SDF data file or an SDF program element specify TYPE SDF 3787 3213 301 5 67 Appendix A TAS FTPMSG Error Messages File This appendix lists the possible error messages that the file transfer facility can encounter when a user on a
127. ession is not currently active or if you want to close the current session and open a session with another host For more information about specifying hostids see Section 1 USERID remote user id The user identifier as required by the remote host Use 1 to 12 alphanumeric characters PASSWORD remote password The password as required by the remote host Use 1 to 18 alphanumeric characters ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 1 shows how to allocate 7168 bytes of storage for a file A session is already established with the remote host C gt ALLO BYTES 7168 FTP 257 Command processing successfully completed Example 5 1 Allocating a File on a Remote Foreign Host Using the ALLOCATE Command 3787 3213 301 5 3 Changing to the Parent Directory CDUP Command 5 3 Changing to the Parent Directory CDUP 54 Command Use the CDUP command to change from the current directory to the parent working directory on a remote foreign host If you specify a host id any existing session is closed and a new session is opened with the specified host Note When you issue this commana the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format CDUP HOST host id USERID remote user id PASSWORD remote password ACCOUNT
128. eve Account Project Source a Dest SITFJB DAS 2 6963828 DDN Siteinfo Accept Data lt gt FTP5095 Command completed successfully a o Example 3 30 Transferring a File Local to Remote Using the TRANSFER Screen 3 19 3 Transferring a File or Element Remote to Local Procedure To transfer a file or element from a remote host to the local host l Display the TRANSFER screen from the MAIN MENU or from any other command screen Enter the identifier of the source host in the Source Host field Enter the sending file name or file name and element name in the Source File Name field Enter the receiving file name or file name and element name in the Destination File Name field Enter a user id in the source 1 Userid field if your local user id is not valid for the source host Enter a user id in the destination 2 Userid field if your local user id is not valid for the destination host Enter a password in the Source 1 Password field Enter an account number in the Source 1 Account field if you local account information is not valid for the source host Enter an account number in the destination 2 Account field if your local account information is not valid for the destination host 3787 3213 301 3 83 Transferring a File TRANSFER Screen 10 Enter a project identifier in the source 1 Project field if you do not want to use the default 11 Enter a project identifier in the De
129. fer When you specify both remote password 1 and remote password 2 remote password 1 is used for the source host FROM and remote password 2 is used for the destination host TO Use a space to separate the clearance level from the password Specifies the user ids for the file transfer Use 1 to 12 alphanumeric characters for a user id The default is the user id on your local host A user id is required for a file on a remote host A user id is required for a file on a local host when the file has read write keys or has a USE name attached to it When you only specify remote user id 1 that user id is used for both hosts involved in the transfer When no remote hosts are involved the user id is used for both files on your local host When you specify both remote user id 1 and remote user id 2 then user id 1 is used for the source host FROM and user id 2 is used for the destination host TO The clearance level as required by the host Use a number between 0 and 63 continued 5 49 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont ACCOUNT remote account info 1 For an OS 2200 host account information remote account info 2 includes the account number followed by the project id Use 1 to 25 alphanumeric characters Use 1 to 12 alphanumeric characters to specify the account number and 1 to 12 alphanumeric characters to specify th
130. fer to Methods of Transferring Files in 1 3 Screen Figure 3 9 shows the LOGIN screen FON FTP 6R1 LOGIN 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host name Userid Password Clearance Level Account Project Accept Data lt gt S Figure 3 9 LOGIN Screen Screen Field Descriptions Table 3 8 describes the fields in the LOGIN screen 3787 3213 301 3 35 Opening a Session with a Remote Host LOGIN Screen 3 36 Table 3 8 LOGIN Screen Fields es Host name The name of the remote host with which you wish to establish a session Enter between 1 and 255 characters This field is required For more information about specifying host ids see Section 1 Userid The userid as required to log onto the remote host This field is optional Password The password as required by the remote host Use 1 to 18 alphanumeric characters This field is optional Account The account number as required by the remote host Use 1 to 12 characters The project number as required by the remote host Procedure To open a session with a remote host 1 Display the LOGIN screen from the MAIN MENU or from any other command screen no In the Host name field enter the identifier of the remote host with which you wish to establish a session In the Userid field enter the userid that the remote host expects In the Password f
131. ferring a File or Element Local to Remote Function Use this format to transfer a file or element from a local to a remote host Format TRANSFER FROM file name 1 element name 1 TO host id file name 2 element name 2 PASSWORD remote password 1 remote password 2 USERID remote user id 1 remote user id 2 EEE ARANCE LEVEL clearance level 1 clearance level 3 i ACCOUNT Yremote account info 1 remote account info 2 See Table 5 16 for information about parameter values If you want to include additional file transfer information for example defining the file type see Including More Specific Information about a File Transfer later in this section Example Example 5 25 shows how to transfer a file from a local host to a remote host In this example we e Omit the keyword portions FROM and TO because we are using positional notation e Specify a password for the remote destination host gt C gt TRAN SDFFILE SD 01 SDFILE PASS DDK gt END COMMAND Example 5 25 Transferring a File Local to Remote Using the TRANSFER Command 5 20 3 Transferring a File or Element Remote to Local 5 56 3787 3213 301 Transferring a File TRANSFER Command Function Use this format to transfer a file or element from a remote to a local host Format TRANSFER FROM host id file name 1 e lement name 1 TO file name 2 e ement name 2 PASSWORD remote password 1 remote password 2 U
132. file on the TRANSFER or PUT command screen 7 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen Example Example 3 26 shows the contents of a sample checkpoint file 3787 3213 301 3 67 Restarting a File Transfer RESUME Screen OS FROM FILEA TO SD 01 FILEB USER DDNJM ACCO 696382860010 POSI R TYPE S TRAN T MODE B STRU F MAXR 3968 CHEC CHK MARK 10 MARK 640 0 640 0 16 17 40 MARK 1280 0 1280 0 16 17 41 MARK 1920 0 1920 0 16 17 42 MARK 2560 0 2560 0 16 17 42 MARK 3200 0 3200 0 16 17 43 MARK 3840 0 3840 0 16 17 43 MARK 4480 0 4480 0 16 17 43 aI Example 3 26 Sample Checkpoint File Example 3 27 shows how to restart a file transfer by selecting 1920 as the restart checkpoint id D FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name CHK At checkpoint id 1920 From file password FILEA Clearance Level _ To file password FILEB Clearance Level Accept Data lt gt FTP5095 Command completed successfully at Example 3 27 Specifying a Restart Point Using the RESUME Command Screen 3 68 3787 3213 301 Getting Filename and File Registration Status STATUS REQUEST Screen 3 18 Getting Filename and File Registration Status STATUS REQUEST Screen Function Use the STATUS REQUEST s
133. fy the CHECKPOINT parameter You did not specify MODE STREAM You only need to specify the first half of the checkpoint id integer to the left of the equal sign If you specify 0 no checkpoint ids are inserted into the checkpoint file For more information about checkpointing see Section 1 SITEINFO information Specifies information not included in the FTP protocol commands Only certain foreign hosts request site information 5 20 1 Transferring a File or Element within a Local Host Function Use this format to transfer a file or element within a local host Format TRANSFER FROM file name 1 element name 1 T0 file name 2 e ement name 2 PASSWORD remote password 1 remote password 2 See Table 5 16 for information about parameter values To include additional file transfer information for example defining the file type see Including More Specific Information About a File Transfer later in this section Example Example 5 24 shows how to transfer an element within a local host In this example we e Omit the keyword portions FROM and TO because we are using positional notation 3787 3213 301 5 55 Transferring a File TRANSFER Command e Specify passwords because the file has read write keys gt C gt TRAN SYMELEMENTS SYMA SQA SYMELEMENTS SYMB PASS HDA FSD gt END COMMAND Example 5 24 Transferring an Element within the Local Host Using the TRANSFER Command 5 20 2 Trans
134. g a File for Event Notification REGISTER Screen Screen Field Descriptions Table 3 11 describes the fields in the REGISTER screen Table 3 11 REGISTER Screen Fields es Application ID This identifies the owner of the event notification record It is used by TAS to associate registered filenames with an owner to be used when deregistering all file names or when obtaining even notification status Use 1 to 12 alphanumeric characters This field is required Filename This is the name of the file you want to register This must be a valid OS 2200 name and must include at last a qualifier and file name This field is required Runstream This is the name of the user defined runstream that will be started when this registered file is received This must be a valid OS 2200 filenameand must include at least a qualifier and file name This field is required Start Options The options used to start the user defined runstream The valid start options are B C E to L M N P R to U and W to Z The X option is supported if the user has sufficient privileges This field is optional Wild Card This indicates which character in theFILENAME field should be treated as a wild Character card when TAS matches an incoming file name with a registered one Use only one character The value must be alphabetic or numeric One Time YES Deregisters the filename when a file transfer is received that Registration matches the file name tha
135. g information before you begin your first session e Format type to specify host ids See Section 1 e Log on procedure in use at your site e Sign off procedure in use at your site 4 1 1 Starting Up The command interface operates in an Interactive Processing Facility IPF 1100 environment You must enter IPF 1100 before you issue any file transfer commands To begin 1 Log on to the local host using your site specific procedure 2 Type IPF and transmit the command IPF 1100 displays the following information e Current level of IPF 1100 e Date e Time e Start of entry symbol gt C gt Example 4 1 shows how to begin IPF gt IPF 1100 6R1 04 11 94 11 50 20 gt C Example 4 1 Starting the Command Interface 3787 3213 301 4 1 Starting and Ending 4 1 2 4 2 Once you enter IPF 1100 you can enter any file transfer command next to the start of entry symbol For example gt C gt FHELP Ending When you finish entering file transfer and IPF 1100 commands close the session if the session is currently open LOGOUT and exit IPF 1100 LOGOFF Note Ifyou issue a command which establishes a session with a remote host and leaves the session open you must issue a LOGOUT command before you issue a LOGOFF command A dump results otherwise To do so enter LOGOUT followed by LOGOFF next to the start of entry symbols For example gt C gt LOGOUT gt C gt LOGOFF You receiv
136. gt Account ST 103 Accept Data lt gt Example 3 1 Reserving Storage on a Remote Host for the Transferred File 34 3787 3213 301 Changing to the Parent Directory CHANGE TO PARENT DIRECTORY Screen 3 3 Changing to the Parent Directory CHANGE TO PARENT DIRECTORY Screen Function Use the CHANGE TO PARENT DIRECTORY screen to change to the parent of the current working directory on a remote foreign host If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 2 shows the CHANGE TO PARENT DIRECTORY screen Oe ee ee eta FTP 6R1 CHANGE TO PARENT DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Userid Password Account Accept Data lt gt S l o Figure 3 2 CHANGE TO PARENT DIRECTORY Screen Screen Field Descriptions Table 3 2 describes the fields in the CHANGE TO PARENT DIRECTORY screen 3787 3213 301 3 5 Changing to the Parent Directory CHANGE TO PARENT DIRECTORY Screen 3 6 Table 3 2 CHANGE TO PARENT DIRECTORY Screen Fields ee The name of the remote host where you want to change to the parent directory Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new sessio
137. i Dal eat igs Sa Blo bee E soln ETEA Transferring Information Using the FSITE Screen 2 oe ee Transferring a File Using the GET Screen eee Opening a Session Using the LOGIN Screen 0 ee Creatinga Directory gt ises gd oienbe hae De eed Me ohh hl 4 Loa Bees Displaying the Current Directory Name sd eee Transferring a File Using the PUT Screen oe eee Registering a Filename Using the REGISTER Screen Registering a Filename with a Wildcard Character 0 Registering Using One Time Registration and Save Status Removing a Directory 00 0 teens Renaming a File Using the RENAME Screen 0000 Restarting a File Transfer within a Local Host Using the RESUME Screen Restarting a File Transfer Local to Remote Using the RESUME Screen Restarting a File Transfer from a Remote Host to a Local Host Using the RESUME Sereen Leren e e cosine eagle ey Oa re ond Restarting a File Transfer between Remote Hosts Using the RESUME GMCCM Aeon a hat ht Sih th Aah a A i aed a BN xiii 3 27 3 27 3 28 3 29 3 32 3 34 3 37 3 40 3 42 3 44 3 52 3 53 3 54 3 57 3 60 3 63 3 64 3 65 3 66 Examples XIV 3 26 5 10 5 11 5 12 5 13 5 14 5 15 5 16 5 17 5 18 5 19 5 20 Sample Checkpoint File 00 eae Specifying a Restart Point Using the RESUME Command Screen Using the STATUS REQUEST Screen 2 ee Transferring an Element within th
138. ield enter the password as required by the remote host In the Clearance level field specify the clearance level that the remote host expects In the Account field enter the account number as required by the remote host In the Project field enter the project number that the remote host expects ono p gt amp Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen Example Example 3 13 shows how to open a session using the LOGIN command 3787 3213 301 Opening a Session with a Remote Host LOGIN Screen it ae ey FTP 6R1 LOGIN 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host name REMOTE1 Userid SMITH J_ Password jrs Clearance Level Account unisys Project Accept Data lt gt Bs Example 3 13 Opening a Session Using the LOGIN Screen 3787 3213 301 3 37 Making a Directory on a Remote Host MAKE DIRECTORY Screen 3 11 3 38 Making a Directory on a Remote Host MAKE DIRECTORY Screen Function Use the MAKE DIRECTORY screen to create a new directory or subdirectory on a remote foreign host If you enter a host name any existing session is closed and a new session is opened with the specified host Screen Figure 3 10 shows the MAKE DIRECTORY screen lm FTP 6R1 MAKE DIRECTORY 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Ma
139. ign e Are not case sensitive for example HOSTABC and HOSTabce are identical The following example shows how to specify a host id using the logical host name format SD 01 When You Should Not Specify a Local Host id When you transfer a file you should omit the host id for a local host If you specify a local host id in a file transfer between an OS 2200 host and a foreign host you may receive an error message Note The file transfer facility uses the local host id as the default When You Should Specify a Remote Host id Note the following conditions which explain when to specify a host id e When you transfer a file using the TRANSFER command you should specify a host id e Ifyou have executed a command that leaves the session open and you want to Continue working in the session currently open do not specify a host id Close the current session or open a new one specify a host id 3787 3213 301 1 9 What Do I Need to Know to Use File Transfer See the next subsection Methods of Transferring Files for more information about sessions 1 3 3 Methods of Transferring Files There are two ways that you can transfer files with FTP e Using the TRANSFER command e Establishing a session with the LOGIN command and then issuing GET FGET or PUT FPUT commands Transferring Files using the TRANSFER Command The TRANSFER command allows you to transfer files e Between files on the local host e From the
140. ile Transfer user commands are TRANSFER DEALLOCATE RESUME FHELP RENAME FSITE LOGIN FGET FPUT FREGISTER DREGISTER FSTATUS and LOGOUT YrvvrvvrvrvvvVvVrVyYVvYrVyVYVYYVYVYVYVYYVY Example 5 8 Listing Available Functions on a Local Host Using FHELP 5 8 2 Listing Available Functions on a Remote Host Function Use this format to list available functions on a remote host Format FHELP HOST host id See Table 5 6 for information about parameter values Example Example 5 9 shows how to list available functions on remote host SD 01 3787 3213 301 5 17 Getting Help FHELP Command 5 18 fee ws le eee 8S C gt FHELP SD 01 gt The AJAX Model 100 Operating System provides a file transfer protocol FTP implementation that includes the basic set of commands Specifically the following commands are supported USER QUIT PORT TYPE MODE STRU RETR STOR NOOP Appropriate error messages are returned when commands other than those listed above are attempted Example 5 9 Listing Available Functions on a Remote Host Using FHELP 3787 3213 301 Sending a File During a Session FPUT Command 5 9 Sending a File During a Session FPUT Command Use the FPUT command to transfer a file to a remote host with which you already have a session open If you need to open a session use LOGON and then FPUT Command Format FPUT FROM file name 1 element name 1 1 TO file name 2 element name 2 2 PASSW
141. in Menu lt gt Command _ lt gt Host Directory Userid Password Account Accept Data lt gt eT Figure 3 10 MAKE DIRECTORY Screen Screen Field Descriptions Table 3 9 describes the fields in the MAKE DIRECTORY screen 3787 3213 301 Making a Directory on a Remote Host MAKE DIRECTORY Screen Table 3 9 MAKE DIRECTORY Screen Fields es The name of the remote host where you want to create a directory or subdirectory Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required if a session is not currently active For more information about specifying host ids see Section 1 Directory The name of the directory or subdirectory you want to create on a foreign host This field is required Userid Specifies a userid to access the directory on the remote host if required Use 1 to 12 alphanumeric characters Password The password required to access the directory on the remote host This parameter may be optional depending on the requirements of the remote host a Use 1 to 18 alphanumeric characters Account Account number to access the directory on the remote host if required Use 1 to 12 characters Procedure To make a directory on a remote host 1 Display the MAKE DIRECTORY screen from the
142. ined herein is subject to change without notice Revisions may be issued to advise of such changes and or additions RESTRICTED Use reproduction or disclosure is subject to the restrictions set forth in DFARS 252 227 7013 and 252 11 15 FAR 52 227 14 amp 52 227 19 for commercial computer software Correspondence regarding this publication should be forwarded to Unisys Corporation either by using the Business Reply Mail form included with this document or by addressing remarks to Unisys Corporation Tredyffrin Malvern Product Information Malvern Development Center P O Box 203 Paoli PA 19301 U S A Comments about documentation can also be sent through e mail to aspgpi unisys com Unisys is a registered trademark of Unisys Corporation All other terms mentioned in this document that are known to be trademarks or service marks have been appropriately capitalized Unisys Corporation cannot attest to the accuracy of this information Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark Contents About This Guide eee Section 1 Introduction 1 1 WhatIs TAS 00 000 0000 1 1 1 Communication Protocol is TCPAP 1 1 2 TAS Components 00 0000 cece eee 1 1 3 Homogeneous HeterogeneouS 1 1 4 Local Remote Foreign Hosts 2 2 ee ee 1 2 What Is the File Transfer Facility 1 2 1 Types of File Transf
143. ing a File TRANSFER Command 5 20 5 5 58 See Table 5 16 for information about parameter values If you want to include additional file transfer information for example defining the file type see Including More Specific Information about a File Transfer later in this section Example Example 5 27 shows how to transfer an element between remote hosts In this example for both the remote source and destination hosts we specify a e Password e User id e Account information In the example we also include an ampersand amp at the end of the first and second line to indicate the command continues on the next line gt C gt TRAN FROM BC 01 SYMELEMENTS SYM TO QUE A SYMELEMENTS SYM amp gt C amp gt PASS BNK CAZ USERID SITFJB BBMET1 ACCO ST 105 DB SB 101 DDN gt END COMMAND Example 5 27 Transferring an Element between Remote Hosts Using the TRANSFER Command Including More Specific Information about a File Transfer When you know the characteristics of the source and destination hosts you can e Use additional parameters in the TRANSFER command to provide more specific file transfer information e Transfer a file more efficiently In the TRANSFER command you can also e Define the sending file or element type TYPE parameter e Identify data representation in the transmission file TRANSLATE parameter e Define transmission data MODE parameter e Define data structure in the transmi
144. ingle filename from event notification Format DREGISTER USERID application id FILE file name See Table 5 5 for information about parameter values Example Example 5 6 shows how to deregister a single filename C gt DREG USERid ftpuser FILE Qual Filename END COMMAND Example 5 6 Deregistering a Single File Note See Section 3 6 for more information about deregistration 5 6 2 Deregistering All Filenames Function Use this format to deregister all filenames for an application or user 3787 3213 301 5 13 Deregistering a Filename DREGISTER Command Format DREGISTER USERID application id FILE file name WILD wi 1d card character DREG_ALL YES NO See Table 5 5 for information about parameter values Example Example 5 7 shows how to deregister all filenames gt C gt DREG USERid ftpuser DREG_ALL YES gt END COMMAND Example 5 7 Deregistering All Filenames 5 14 3787 3213 301 Getting a File during a Session FGET command 5 7 Getting a File during a Session FGET command Use this command to transfer a file from a remote host for which you have established a session to your local host If you need to open a session use the LOGIN command and then FGET Command Format FGET FROM file name 1 element name 1 1 TO file name 2 element name 2 2 PASSWORD remote password 1 remote password 2 3 USERID remote user id 1 remote user id 2 FGBEARANCE LEVEL
145. ion How you enter information on a screen depends on the type of field you want to complete Table 2 2 shows how to complete the different types of command screen fields Table 2 2 Filling in Command Screen Fields An input field Enter information on the blank line A choice field Enter any alphanumeric such as X to the right of your choice Default values are displayed in upper case If you make no selection the default is assumed The Accept Data field Place the cursor between the angle brackets and transmit Note Ifyou decide to start over after entering some field values re enter the id of the command screen on the command line to display a blank screen Required Fields Required fields begin with an asterisk For example Destination File Name You must complete required fields to process a screen If you transmit a screen before completing a required field e The file transfer facility does not process the screen e A message appears in the message section e The cursor moves into the first position of the incomplete field File Name Fields When you enter information in a file name field you must enter the actual name of the file name or file and element name Security Fields Security fields are enclosed in braces For example Password 2 6 3787 3213 301 Using the Menu Interface When you enter information in a security field FTP does not display the information on the screen for securit
146. ion Using Keyword Syntax When you specify parameters using entire keyword syntax you can place them in any order Example 4 5 shows how to use keywords to enter a TRANSFER command gt C gt TRANSFER PASSWORD SNS FROM UCLA SDFFILE TO SD 01 SDFFILE Example 4 5 Using Keyword Syntax to Enter a Command Using Positional Notation When you enter a command you can omit the keyword portion KEYWORD for certain parameters This is called positional notation When you use positional notation you must specify the parameters in the order in which they appear in the command Use commas to separate parameters in positional notation 3787 3213 301 4 5 Using the Command Interface For help on when you can use positional notation see Summary of Commands and Parameters later in this section Example 4 6 shows how to enter a command using positional notation In this example you can omit the keyword portions FROM and TO for the FROM and TO parameters gt C gt TRANSFER UCLA SDFFILE SD 01 SDFFILE Example 4 6 Using Positional Notation to Enter a Command Using a Combination of Keywords and Positional Notation When you specify parameters using a combination of keywords and positional notation parameters in positional notation must appear first Example 4 7 shows how to use keywords and positional notation to enter a TRANSFER command gt C gt TRANSFER UCLA SDFFILE SD 01 SDFFILE ACCO
147. ion 1 Introduction 1 1 What Is TAS TAS TCP IP Application Services is a software product that provides communication among hosts in e An X 25 Public Data Network PDN e A Local Area Network LAN 1 1 1 Communication Protocol is TCP IP The communication protocol used by TAS is TCP IP Transmission Control Protocol Internet Protocol originally defined for the United States Department of Defense Data Network DDN 1 1 2 TAS Components TAS consists of three components e The TAS Mail Processor Provides electronic mail processing capabilities based on the Simple Mail Transfer Protocol Military Standard Simple Mail Processor Protocol MIL STD 1781 For complete information on the TAS Mail Processor see the TAS Mail Processor User Guide e The TAS File Transfer Facility the subject of this manual Provides the ability to transfer and manage files within a host and between hosts It is based on the File Transfer Protocol Military Standard File Transfer Protocol MIL STD 1780 e The TAS programming interfaces Provides facilities for writing applications programs that Invoke the TAS File Transfer Facility or Mail Processor COBOL and FORTRAN Invoke the File Transfer Facility only C Language For complete information about TAS COBOL see the TAS COBOL Programming Guide For information about TAS FORTRAN see the TAS FORTRAN Programming Guide For information about C Language programming see the TAS C
148. ives a clearer picture of the services available as the use of TCP IP has expanded far beyond the Defense Data Network where it originated Purpose The purpose of this guide is to provide information for using the following two file transfer user interfaces e Menu the DPS 2200 menu interface e Command the IPF 1100 command interface Scope This guide contains step by step procedures and need to know information required by a user to transfer and delete files and to access on line help for the file transfer facility Audience The guide is written for programmers and system analysts The secondary audience is site administration personnel Prerequisites There are no prerequisites How to Use This Document This guide is designed to be used as a reference by an individual who will be working at a terminal 3787 3213 301 xvii About This Guide First you should read Section 1 of this guide to gain a general understanding of the file transfer facility This introductory section pertains to both the menu and command interfaces If you wish to use the menu interface read Section 2 and Section 3 To use the command interface refer to Section 4 and Section 5 Organization xviii Section 1 Introduction Describes the file transfer facility functions This section also provides guidelines for specifying host identifiers and file names This section pertains to using both the menu interface and command in
149. le Transfer Checkpointing involves two processes e Passing checkpoint markers between the hosts involved in the file transfer e Recording these markers in the checkpoint file on the local host The location of the file to be transferred and the initiation point of the transfer determine which host will control the checkpoint options The guidelines are Checkpoint Options Determined by Determined by initiating TASMASTER on host host where file resides Whether checkpoint markers are X passed The frequency with which checkpoint X markers are passed Whether checkpoint markers are X recorded in a checkpoint file by specifying or not specifying this option Note For more information on TASMASTER refer to the TAS Implementation and Administration Guide According to file transfer protocol FTP implementation of the checkpoint function is optional The TAS file transfer facility supports checkpointing However other non OS 2200 hosts might not Checkpointing is a valuable tool but it does slightly increase the time required to transfer a file For this reason you should use it with discretion It is recommended for transfers of large files as they are costly to restart from the beginning Contents of Checkpoint File A checkpoint file contains e A description of the file transfer information you specify this information appears once in the checkpoint file e Checkpoint markers checkpoint ids these markers
150. mand screen 2 Ifa session is not already active with the remote host where the file is located enter the name of the host in the Host field In the From file name field enter the name of the file you want to rename 4 Inthe To file name field enter the new file name 5 In the Password field enter the password as required by the foreign host to access the file 6 Inthe Userid field enter the userid as required by the foreign host to access the file 3787 3213 301 3 59 Renaming a File RENAME Screen 3 60 7 Inthe Account field enter the account number as required by the foreign host to access the file 8 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 13 for additional information about field values Example Example 3 21 shows how to rename a file a FTP 6R1 RENAME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host 4 3 0 3 From file name SDFFILE To file name SDFFILE1 Userid Password Account SITFJB DAS Accept Data lt gt eee oo Example 3 21 Renaming a File Using the RENAME Screen 3787 3213 301 Restarting a File Transfer RESUME Screen 3 17 Restarting a File Transfer RESUME Screen Function Use the RESUME command screen to recover a file transfer operation that abnormally terminates You can resume a file transfer
151. n 9 bit bytes the 9th bit of each byte is meaningless and is not transferred you have two options o Ifthe data resides in an SDF file or program element you can specify TRANSLATE TRANSPARENT STRUCTURE FILE and TYPE SDF In this case TAS does not transfer any file control information and sends FTP protocol TYPE T o Ifthe data resides in anon SDF file specify TRANSLATE TRANSPARENT STRUCTURE FILE and TYPE IOW TAS sends FTP protocol TYPE I e When you specify TRANSLATE EBCDIC TAS acting as the initiator will convert the data from ASCII to EBCDIC when your local host is the source host and from EBCDIC to ASCII when your local host is the destination host TAS does this conversion when acting as the server if TYPE E FTP protocol is received e Use MODE COMPRESSED with discretion as it requires additional TAS processing Use this mode only when the file you transfer contains large numbers of replicated characters for example ASCII spaces or binary zeros Also the file transfer is rejected when the remote host does not support compression FTP protocol MODE c Acceptable Parameter Combinations 3 92 Table 3 17 shows acceptable combinations for specifying the Type Translate and Structure fields on the TRANSFER Get and PUT screens In the table the first column indicates the type of file or element you want to transfer The remaining columns indicate the possible combination of values you can specify for the Type
152. n host Use 1 to 12 alphanumeric characters This field may or may not be required when the file resides on a remote host This field may be required if your user id is prompted for a project id The default is determined by your user id s registration with the Exec 3 19 1 Transferring a File or Element within a Local Host 3 80 3787 3213 301 Transferring a File TRANSFER Screen Procedure To transfer a file or element within a local host 1 Display the TRANSFER screen from the MAIN MENU or from any other command screen Enter the file name or file name and element name in the Source File Name field Enter the file name or file name and element name in the Destination File Name field Enter a password in the Source password field if the file has read write keys Enter a password in the Dest password field if the file has read write keys at fF WN If you want to include additional file transfer information for example defining the file type see Including More Specific Information about a File Transfer later in this section 7 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 16 for additional help with field values Example Example 3 29 shows how to transfer an element within the local host POs FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt S
153. n opened This field is required if a session is not currently active For more information about specifying host ids see Section 1 Userid Specifies a userid to access the file on the remote host if required Use 1 to 12 alphanumeric characters Password The password required to access the directory on the remote host This parameter may be optional depending on the requirements of the remote host i Use 1 to 18 alphanumeric characters Account The number required to access the directory on the remote host if required Use 1 to 12 alphanumeric characters Procedure To change from the current directory to its parent directory 1 Display the CHANGE TO PARENT DIRECTORY screen from the MAIN MENU or from any other command screen 2 Ifa session is not already active with the remote host enter the name of the remote host in the Host field 3 Enter your userid password and account number for the remote host if required 4 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 2 for additional information about field values Example Example 3 2 shows how to change from the current directory to its parent directory The host name userid password and account are not needed when a session is already active with the remote host where the directory is located 3787 3213 301 Changing to the Parent Directory CHANGE TO PARENT DIRECTORY Screen Ue a ee e
154. ng a File Name to a File ID Incoming File Transfer 0000 OVERVIEW ones enai 348 neo t ae on e Run Stream Selection The Register Screen oe eee Registering a Filename 005 Registering a Filename with a Wildcard Character Registering Using One Time Registration and Save Stats sfc aaah tu tases Removing a Directory on a Remote Host REMOVE DIRECTORY Screen _ Renaming a File RENAME Screen Restarting a File Transfer RESUME Screen Restarting a File Transfer within a Local Host Restarting a File Transfer Local to Remote Restarting a File Transfer Remote to Local Restarting a File Transfer between Remote Hosts Specifying a Restart Point for a File Transfer RECOVENY lapsa r ra tthe wees Getting Filename and File Registration Status STATUS REQUEST Screen Transferring a File TRANSFER Screen Transferring a File or Element within a Local Host Transferring a File or Element Local to Remote Transferring a File or Element Remote to Local 3 20 a 3 22 325 3 26 3 28 3 30 333 3 35 3 38 3 41 3 43 3 45 3 45 i 3 46 l 3 46 l 3 47 3 49 3 51 3 52 3 53 3 55 3 58 i 3 61 3 62 3 63 3 64 3 65 3 66 3 69 l 3 72 3 80 3 82 3 83 Contents 3 19 4 Transferring a File or Element between Remote HOStS vrcbicseepde eet seek te
155. ng on the requirements of the remote host Use 1 to 18 alphanumeric characters Account The number required to access the directory on the remote host if required Use 1 to 12 alphanumeric characters Procedure To reserve storage to accommodate a transferred file on a remote host 1 Display the ALLOCATE screen from the MAIN MENU or from any other command screen 2 Ifa session is not already active with the remote host where you want to reserve storage enter the name of the remote host in the Host field 3 Enter the number of bytes of storage the file requires in the Bytes field If required enter the number of records of storage you require in the Records field 5 Specify your userid password and account number in their respective fields if required by the remote host 6 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 1 for additional information about field values 3787 3213 301 3 3 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Screen Example Example 3 1 shows how to open a session with a remote host and reserve file storage space BOT FTP 6R1 Host KP 01 Records Userid SITFJB Fl Help lt gt F2 Refresh lt gt ALLOCATE F3 Exit lt gt F4 Main Menu lt gt Bytes 7168 SNS Password FTP5095 Command completed successfully et 97 08 30 Command _ lt
156. nsfer between Remote Hosts Using the RESUME Command 5 19 5 Specifying a Restart Point for a File Transfer Recovery Function Use the AT parameter to specify a checkpoint id checkpoint marker The checkpoint id indicates where you want to resume a transfer If you do not specify a value for the AT parameter the transfer resumes at the last checkpoint id in the checkpoint file You can e Use this parameter with any type of file transfer See the previous subsections e Restart a file transfer from any one of the checkpoint ids reported in the checkpoint file Format RESUME FILE file name AT checkpoint id PASSWORD remote password 1 remote password 2 See Table 5 15 for information about parameter values Additional Information To determine a restart point you need to access the checkpoint file Display the checkpoint file using any OS 2200 system editor 3787 3213 301 5 43 Restarting a File Transfer RESUME Command Caution Do not change the contents of the checkpoint file If you do you may not be able to recover the file Select a checkpoint id from the checkpoint file to use as the restart point for the file transfer The checkpoint id is located after the word MARK and before the equal sign If you omit the hyphen and the 0 a value of 0 is assumed For example MARK 1920 0 1920 0 16 17 41 In this example you can specify the checkpoint id as 1920 0 or 1920 with the same effect For a
157. oint file you specified on the TRANSFER screen 3 Inthe From file password field enter the password you specified for the source file on the TRANSFER command screen 4 Inthe To file password field enter the password you specified for the destination file on the TRANSFER command screen 5 If you want to specify where to restart a file transfer see Specifying a Restart Point for a File Transfer Recovery later in this section 6 Transmit the screen 3787 3213 301 3 65 Restarting a File Transfer RESUME Screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 14 for additional information about field values Example Example 3 25 shows how to restart a file transfer between remote hosts a FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name CHK At checkpoint id From file password SNS Clearance Level _ To file password RHD Clearance Level __ Accept Data lt gt FTP5095 Command completed successfully NY Example 3 25 Restarting a File Transfer between Remote Hosts Using the RESUME Screen 3 17 5 Specifying a Restart Point for a File Transfer Recovery Use the At checkpoint id field to specify a checkpoint id checkpoint marker The checkpoint id indicates where you want to resume a transfer You can e Use this field for any type of
158. ol implementations can include different functionality For example many implementations do not accept record structure STRUCTURE RECORD You may want to transfer a file to a host for temporary storage That is the file is not used on the destination host only stored and returned later to the original host Specify STRUCTURE FILE and TRANSLATE TRANSPARENT If TAS is acting as the server for the transfer the user on the remote host should specify whatever parameters his system requires to cause the FTP protocol commands STRU F and TYPE I to be sent Specify a checkpoint mark only when You specify a checkpoint file name The sending file is on your local host Do not specify a checkpoint file name when you specify MODE STREAM Guidelines for Transfers between OS 2200 Hosts When you transfer a file between OS 2200 hosts follow these guidelines Use STRUCTURE FILE for the fastest transfer When using the Position parameter Do not replace an element with a file Add only elements to a program file When you add an element you must specify an element name for both the FROM and TO parameters Do not add data to an element Do not add data to an SDF file Do not specify SOURCE SDF or IOW for TYPE Do not specify MODE COMPRESSED 3787 3213 301 5 61 Transferring a File TRANSFER Command Guidelines for Transfers Involving Foreign Hosts 5 62 When you transfer a file involving a foreign ho
159. omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required if a session is not currently active For more information about specifying host ids see Section 1 Directory The name of the directory you want to remove Use 1 to 132 alphanumeric characters This field is required Userid The user identifier required to access the remote host This field is optional depending upon the requirements of the remote host Use 1 to 12 alphanumeric characters Password The password as required by the remote host Use 1 to 18 alphanumeric characters Account The account number as required by the remote host This field is optional depending upon the requirements of the remote host Use 1 to 12 alphanumeric characters Procedure To remove a directory 1 Display the REMOVE DIRECTORY screen from the MAIN MENU or from any other command screen 2 Ifa session is not already active with the remote host where you want to remove the directory enter the name of the remote host in the Host field In the Directory field enter the name of the directory to be removed 4 Inthe Userid field enter the userid as required by the foreign host to access the directory 5 Inthe Password field enter the password as required by the foreign host to access the directory 6 Inthe Account field enter the
160. ommand Keyword Parameter Descriptions HOST host id The identifier of the host where the directory resides Use 1 to 255 alphanumeric characters If you omit the hostid the host to which you are currently logged in is used Specify a host id if a session is not currently active or if you want to close the current session and open a session with another host For more information about specifying host ids see Section 1 USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters PASSWORD remote password The password as required by the foreign host Use 1 to 18 alphanumeric characters continued 3787 3213 301 5 33 Printing the Current Directory on a Remote Host PWD Command Table 5 12 PWD Command Keyword Parameter Descriptions cont ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 15 shows how to open a session with a remote host and display the name of the current working directory C gt PWD HOST KP 01 USER TAS1 PASS PUBS FTP 257 Command processing successfully completed gt TAS 5R3Q2 0519 1 TAS 2200 Connection With Remote Host Established FTP 257 Command processing successfully completed gt src tas d2 is current directory Example 5 15 Printing the Name of the Current Directory Using the PWD Command 5 34
161. ost Use a number between 0 and 63 continued 5 9 Deleting a File DEALLOCATE Command 5 5 1 5 10 Table 5 4 DEALLOCATE Command Keyword Parameter Descriptions cont ACCOUNT remote account info Deleting a File on a Local Host Function For an OS 2200 host account information includes the account number followed by the project id Use 1 to 25 alphanumeric characters Use 1 to 12 alphanumeric characters to specify the account number and 1 to 12 alphanumeric characters to specify the project id Use a space to separate the account number from the projectid When you include a space enclose the account information in double quotes When you specify a projectid it is passed to the remote host regardless of whether that host is an OS 2200 host The account number associated with your run is always used for processing on your local host Use this format to delete a file on a local host This example assumes that you are not currently in a session with a remote host Format DEALLOCATE FILE file name See Table 5 4 for information about parameter values Example Example 5 4 shows how to delete the file SDFFILE1 from a local host In this example we omit the keyword FILE because we are using positional notation Example 5 4 Deleting a File on a Local Host Using the DEALLOCATE Command cont 3787 3213 301 Deleting a File DEALLOCATE Command gt C gt DEAL SDFFILE1
162. ost 4 3 0 3 Source File Name SYMELEMENTS SYM2 Destination Host Destination File Name SYMELEMENTS SYM1 Type SYM All Omn Sdf Iow Max Record Size Translate Transparent _ Ascii x Ebcdic _ L36 _ Mode STREAM Block Compressed Position REPLACE Add Structure FILE _ Record x Checkpoint mark Checkpoint file name Userid Password Leve Account Project Source ee cee Dest e G Siteinfo Accept Data lt gt FTP5095 Command completed successfully S Example 3 34 Transferring a Symbolic Element from a Remote Host to the Local Host Using the TRANSFER Screen Example 3 35 transfers a symbolic file containing data in EBCDIC code from the local host to a remote host E FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name SDFFILE Destination Host 4 3 0 3 Destination File Name SDFFILE1 Type SYM All Omn Sdf Tow Max Record Size Translate Transparent _ Ascii _ Ebcdic x L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE Record x Checkpoint mark Checkpoint file name Siteinfo Accept Data lt gt FTP5095 Command completed successfully S Example 3 35 Transferring a File Containing EBCDIC Code from the Local Host to a Remote Host Using the TRANSFER Screen Example 3 36 transfers a local file to a remote file as sequential records 3787 3213 30
163. ource Host Source File Name SYMELEMENTS SYMA Destination Host Destination File Name SQA SYMELEMENTS SYMB Type SYM All Omn Sdf Tow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM _ Block _ Compressed _ Position REPLACE Add _ Structure FILE Record Checkpoint mark Checkpoint file name Userid Password Level Account Project Source Dest Siteinfo Accept Data lt gt FTP5095 Command completed successfully NY Example 3 29 Transferring an Element within the Local Host Using the TRANSFER Screen 3787 3213 301 381 Transferring a File TRANSFER Screen 3 19 2 Transferring a File or Element Local to Remote Procedure To transfer a file or element from the local host to a remote host l 10 11 12 13 Display the TRANSFER screen from the MAIN MENU or from any other command screen Enter the sending file name or file name and element name in the Source File Name field Enter the identifier of the destination host in the Destination Host field Enter the receiving file name or file name and element name in the Destination File Name field Enter a user id in the source 1 Userid field if your local user id is not valid for the source host Enter a user id in the destination 2 Userid field if your local user id is not valid for the destination host Enter a password in the destination 2 Password field Enter an accoun
164. owing are true e The sending file is on your local host e The checkpoint file name is specified e The mode specified for this transfer is not STREAM The default is every 250 tracks For more information on checkpointing see Section 1 Siteinfo Gives information not included in the TAS FTP protocol commands Only certain foreign hosts use site information The FTP protocol must be included in the information See the FSITE screen for more details about this field continued 3787 3213 301 3 77 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont ee Structure Subfield Description FILE Transfers the file contiguously This is the most efficient structure when transferring between OS 2200 hosts When you use FILE when transferring an entire file file control information associated with an OS 2200 SDF file is transmitted to the remote host This can make the file unreadable to a non OS 2200 host although the file becomes readable when returned to the originating OS 2200 host The default is FILE Record Transfers the file in sequential record format Use this structure when the destination host s file structure is record oriented The file transfer facility includes record trailers during transmission Use this option when you transfer data to a non OS 2200 host with a file structure that may be incompatible with OS 2200 file formats Structure Record transmits only the data
165. pecified host For more information on FHELP see 3 7 Accessing General Help To access general help either e Press the F1 function key on the MAIN MENU e Move the cursor to the Fl Help lt gt field at the top of the MAIN MENU and transmit Example 2 5 shows how to access general help from the MAIN MENU e a a nan aT FTP 6R1 FILE TRANSFER PROTOCOL 97 08 30 MAIN MENU Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt Move the cursor to the desired command and transmit or Type the desired command code and transmit File Transfer lt gt tr Transfer lt gt lo Login lt gt al Allocate lt gt re Resume lt gt ge Get lt gt cp Change to Parent lt gt de Deallocate lt gt pu Put lt gt cd Change Work Dir lt gt rn Rename lt gt cl Close lt gt md Make Dir lt gt fs Fsite lt gt rf Register lt gt pw Print Work Dir lt gt fh Fhelp lt gt dr De register lt gt rd Remove Dir lt gt sr Status Request seso oo Example 2 5 Accessing General Help from the Main Menu 3787 3213 301 Using On Line Help for Screens 2 3 3 When you transmit a general help menu is displayed from which you can access e An overview of the file transfer facility e Help with filling in command screens e Help with using function keys Accessing Command Screen Help To access command help for the command screen currently displayed either e Press the F1 function key e Mov
166. protocol commands should be STRU F and TYPE I Use the same values to retrieve the file Omnibus element OS 2200 to Use on destination host STRUCTURE RECORD non OS 2200 TRANSLATE TRANSPARENT TYPE OMNIBUS When the transfer is initiated by the foreign host the FTP protocol commands should be STRU R and TYPE I continued 3787 3213 301 3 95 Transferring a File TRANSFER Screen Table 3 18 Sample File Transfer Situations cont Type of File or Hosts Involved Transfer Purpose Recommended Field Values Element EBCDIC data file Non OS 2200 to Use on destination host STRUCTURE RECORD OS 2200 TRANSLATE EBCDIC When the foreign host does not support record structure specify STRUCTURE FILE TRANSLATE EBCDIC When the transfer is initiated on the foreign host the FTP protocol commands should be STRU R and TYPE E or STRU F and TYPE E The data in the file will be converted by TAS from EBCDIC to ASCII character format Binary file of 8 bit OS 2200 to Possible use on TRANSLATE TRANSPARENT data non OS 2200 destination host When the data for the OS 2200 host or comes from or goes to a file that you will Non 08 2200 to access via ER IOWS specify TYPE IOW OS 2200 When the data for the OS 2200 host comes from or goes to an SDF data file or an SDF program element specify TYPE SDF 3 96 3787 3213 301 Section 4 Getting Started with the Command Interface 4 1 Starting and Ending Obtain the followin
167. r for the source host Use 1 to 12 alphanumeric characters Project The project id for the source host Use 1 to 12 alphanumeric characters This field may or may not be required when the file resides on a remote host This field may be required if your user id is prompted for a project id The default depends on your user id s registration with the Exec continued 3787 3213 301 3 79 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont a Subfield Description Userid The user identifier for the destination host Use 1 to 12 alphanumeric characters This field is required when the file resides on a remote host This field is required when the file resides on your local host and the file has read write keys or has a USE name attached to it The default is your user id on your local host Password The password for the destination host Use 1 to 18 alphanumeric characters This field is generally required when the file resides on a remote host This field is required when the file resides on your local host and the file has read write keys or has a USE name attached to it The default is blank characters Level The clearance level for the destination host Enter a number between 0 and 63 Account The account number for the destination host Use 1 to 12 alphanumeric characters The default is your account number on your local host Project The project id for the destinatio
168. r id Password Account SITFJB DAS Accept Data lt gt Sooo o Example 3 11 Transferring Information Using the FSITE Screen 3 32 3787 3213 301 Requesting a File During a Session GET Screen 3 9 Requesting a File During a Session GET Screen Function Use the GET screen to transfer a file from a remote host to your local host during a session Before using the GET screen use the LOGIN screen to open a session Refer to e Methods of Transferring Files in 1 3 for a discussion of the differences between the GET and PUT commands and the TRANSFER command e 3 19 Transferring a File for more information about file transfers keeping in mind that while using GET you are only transferring in one direction and that a session is open between the two hosts Screen Figure 3 8 shows the GET screen E s FTP 6R1 GET 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source File Name on remote host Destination File Name on local host Type SYM AT Omn _ Sdf Tow Max Record Size Translate Transparent Ascii Ebcdic L36 Mode STREAM _ Block Compressed Position REPLACE _ Add Structure FILE Record _ Checkpoint mark Checkpoint File Name Userid Password Level Account Project remote Siteinfo Accept Data lt gt Me es Figure 3 8 GET Screen Screen Field Descriptions Refer to the discussion of the TRANSFER screen for
169. ram e Partial files of these types Symbolic Omnibus For additional information refer to Table 3 11 and Table 5 10 1 2 3 File Transfer User Interfaces 1 4 You can use any of the following interfaces to access and use the file transfer facility e Menus Display Processing System DPS 2200 menu interface e Commands Interactive Processing Facility TPF 1100 command interface e Programs Programming interfaces COBOL FORTRAN C Language _ ea 3787 3213 301 What Is the File Transfer Facility The menu DPS and command IPF interfaces are described in this manual Each of the programming languages is discussed in its own document 1 2 4 Overview of File Transfer Functions Table 1 1 describes the file transfer functions Table 1 1 Overview of File Transfer Functions Command Description Screen Command ALLOCATE Allocates storage space on a remote foreign host for the file you want to transfer CHANGE TO PARENT Changes the active directory on a remote foreign host to the DIRECTORY CDUP parent of the current working directory CLOSE LOGOUT Ends a session with a remote host There is no command screen for CLOSE Instead CLOSE cl is entered on the command line or selected from the MAIN MENU CHANGE WORK Changes the active directory on a remote foreign host for file DIRECTORY CWD storage or file retrieval DEALLOCATE Deletes a file on e Your local host e Aremote host
170. ransfer a symbolic element TRANSPARENT when you transfer an entire program file or SDF file TRANLATE EBCDIC Translates the file to 8 bit EBCDIC code continued during the transfer TRANLATE TRANSPARENT Use TRANSPARENT when the data type is continued something other than ASCII or EBCDIC Use for binary floating point or control characters Transfers an entire program file Performs no translation in the transmission file The default is e TRANSPARENT when you transfer an entire program file or SDF file ASCII when you transfer a symbolic element TRANLATE Notifies a remote host that the local byte continued size of the transferred data is 36 bits binary data You do not need to specify this parameter to transfer files between OS 2200 hosts MODE STREAM Transfers data in a stream This is the most efficient transfer mode between OS 2200 hosts You cannot specify a checkpoint file if MODE STREAM The default is STREAM MODE continued BLOCK Sends data as a series of blocks preceded by a header continued 5 52 3787 3213 301 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont MODE continued COMPRESSED Use this mode when transferring data that contains numerous replications of fillers such as program files This mode is not supported for transfers between OS 2200 hosts STRUCTURE FILE Transfers the file contiguously This is the
171. rden hae 5 58 5 20 6 File Transfer Guidelines 00 0 5 61 Guidelines for All Types of Transfers 5 61 Guidelines for Transfers between OS 2200 HOSTE hie encore hed cuca ential Wes tte eter A 24 5 61 Guidelines for Transfers Involving Foreign Hosts 5 62 Acceptable Parameter Combinations 5 63 5 20 7 Sample File Transfer Situations 5 63 Appendix A TAS FTPMSG Error Messages File Bibliography viii 3787 3213 301 Figures 2 1 Sample Command Screen can wcercuc diet a igini iney a EA E TES 2 3 3 1 ALOCATE SCTEBM odoro ta tee Rud Ga a ath RE a ai 3 2 3 2 CHANGE TO PARENT DIRECTORY Screen 0 00 000 35 33 CHANGE WORKING DIRECTORY Screen 0 000000 3 8 3 4 DEALLOCATE Sereen Sorrera os Dane ee Teenie Dewees 3 11 3 5 DREGISTER SCFECN speer ratte RA ei a The te eT 3 15 3 6 FHELP Sereen Anoe ecu estan eed te ate eM ly A e e Mu cite Bde eos 3 25 3 7 FME SCEE anara A ee E S A e e A E 3 30 3 8 EAE E E E E E eich hd cule tee seta PET EEEE E E eats 3 33 3 9 VOGIN SETEN arene sar eke Mee wer A RA Ie ee le aA aa 3 35 3 10 MAKE DIRECTORY Screen 0 00 00 aeaaeae raaa 3 38 3 11 PRINT WORKING DIRECTORY Screen oonan unauna aana 3 41 JZ RUT Seegi orden e eos tee eet A Ae a eee Me a 3 43 F13 REGISTER Sreem sorai ou bes VEA E EE AAU ANEA OEE ES 3 49 3 14 REMOVE DIRECTORY Screen 0 00 00 00 cee eee 3 55 3 15 RENAME Screen eee cehens dal
172. re transferring the file or element Use 1 to 24 alphanumeric characters If you omit the host identifier the local host is used For more information about specifying host ids see Section 1 TO continued fine name 2 Use file name 2 and element name 2 to element name 2 specify the name of the file and element to which you are copying You must specify a file name This must be a valid file name for the system on which the file resides For more information about specifying file names see Section 1 PASSWORD remote password 1 Specifies the passwords and clearance level remote password 2 for the file transfer Use 1 to 18 alphanumeric characters for a password Use 2 alphanumeric characters for the clearance level The default is blank characters A password is generally required for a file on a remote host A password is required for a file on a local host when the file has read write keys or has a USE name attached to it continued 5 48 3787 3213 301 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont PASSWORD remote password 1 continued remote password 2 USERID remote user id 1 remote user id 2 USERID continued remote user id 1 remote user id 2 CLEARANCE_LEVEL clearance level 1 clearance level 2 3787 3213 301 When you only specify remote password 1 that password is used for the remote hosts involved in the trans
173. remote account info Keyword Parameters Table 5 2 describes the keyword parameters for the CDUP command Table 5 2 CDUP Command Keyword Parameter Descriptions HOST host id The identifier of the host where the directory you want to change is located Use 1 to 255 alphanumeric characters If you omit the host id the host to which you are currently logged in is used Specify a hostid if a session is not currently active or if you want to close the current session and open a session with another host For more information about specifying host ids see Section 1 USERID remote user id The user identifier as required by the foreign host Use 1 to 12 alphanumeric characters PASSWORD remote password The password as required by the foreign host Use 1 to 18 alphanumeric characters continued 3787 3213 301 Changing to the Parent Directory CDUP Command Table 5 2 CDUP Command Keyword Parameter Descriptions cont ACCOUNT remote account info The account number as required to access the directory on the remote host Use 1 to 12 alphanumeric characters Example Example 5 2 shows how to change to the parent of the current working directory A session is already established with the remote host C gt CDUP FTP 257 Command processing successfully completed Example 5 2 Changing to the Parent Directory Using the CDUP Command 3787 3213 301 5 5 Changing the Working Directory on a Remote Host C
174. remote host if required 5 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 3 for additional information about field values 3787 3213 301 3 9 Changing the Working Directory CHANGE WORKING DIRECTORY Screen 3 10 Example Example 3 3 shows how to change the current working directory The host name userid password and account are omitted because a session is already active with the remote host where the directory is located se se es rr CCOti C C lt lt i WS FTP 6R1 CHANGE WORKING DIRECTORY Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt Host To specified directory FTP5095 Command completed successfully F4 Main Menu lt gt TAS MEMOS Userid Password 97 08 30 Command __ lt gt Account Accept Data lt gt Example 3 3 Changing the Working Directory on a Remote Host 3787 3213 301 Deleting a File DEALLOCATE Screen 3 5 Deleting a File DEALLOCATE Screen Function Use the DEALLOCATE screen to delete a file on either a e Local host e Remote host When you delete a file you free space on a host for other users You delete one file each time you transmit this screen Note You cannot use the DEALLOCATE command to delete a file element If you enter a host name any existing session is closed and a new session is opened wi
175. remote host invokes the file transfer facility The error messages are written to the file TAS FTPMSG or the DDP PPC log file In the file each error message includes e A time and date stamp e The message number e The message description For some messages in this appendix we provide further help in addition to the message description For information about how to access this file see Section 1 FTP1100 The FTP monitor is now active FTP1110 File Transfer Process internal error occurred when registering for TRMRG notification No further commands can be processed Please report the problem to your system administrator or contact your Unisys representative FTP1120 The following MCP error message was received when the FTP MONITOR issued an MCP SIGNON request message text FTP1130 The following MCP error message was received when the FTP MONITOR issued a PASSIVE OPEN request message text FTP1140 The following MCP error message was received when the FTP monitor issued an MCP PASSOFF request message text FTP1150 The following MCP error message was received when the FTP MONITOR issued a receive of the open id message text FTP1200 The MCP returned conflicting error messages An error status and an ok value The FTP monitor is shutting down Please report the problem to your system administrator or contact your Unisys representative 3787 3213 301 A 1 TAS FTPMSG Error Messages File A 2 FTP1300 FTP1305 F
176. representative FTP internal error was received registering the FTP user run for TRMRG notification Please report the problem to your system administrator or contact your Unisys representative A 3 Bibliography OS 2200 TCP IP Application Services TAS C Language Programming Guide 4173 5135 Unisys Corporation OS 2200 TCP IP Application Services TAS COBOL Programming Guide 3787 3205 Unisys Corporation OS 2200 TCP IP Application Services TAS FORTRAN Programming Guide 3787 3247 Unisys Corporation OS 2200 TCP IP Application Services TAS Implementation and Administration Guide 3787 3221 Unisys Corporation OS 2200 TCP IP Application Services TAS Mail Processor User Guide 8787 3239 Unisys Corporation OS 2200 Distributed Data Processing DDP PPC DDP FJT Messages Reference Manual 3787 3528 Unisys Corporation OS 2200 Interactive Processing Facility IPF 1100 Command Language User s Guide 7833 3788 Unisys Corporation OS 1100 Universal Compiling System UCS FORTRAN Programming Reference Manual 7830 7477 Unisys Corporation OS 2200 Distributed Data Processing DDP PPC TCP IP Interface FORTRAN Programming Guide 3789 6669 Unisys Corporation OS 2200 Distributed Data Processing DDP PPC TCP IP Interface COBOL Programming Guide 3789 6651 Unisys Corporation OS 2200 Distributed Data Processing DDP PPC TCP IP Interface C Language Programming Guide 8787 3254 Unisys Corporation
177. restart a file transfer within a local host Format RESUME FILE file name PASSWORD remote password 1 remote password 2 See Table 5 15 for information about parameter values If you want to specify a restart point see Specifying a Restart Point for a File Transfer Recovery later in this section Example Example 5 18 shows how to restart a file transfer within a local host In this example we do not specify any passwords because the files do not have read write keys gt C gt RESU FILE CHK gt END COMMAND Example 5 18 Restarting a File Transfer within a Local Host Using the RESUME Command 5 19 2 Restarting a File Transfer Local to Remote Function Use this format to restart a file transfer from a local host to a remote host Format RESUME FILE file name PASSWORD remote password 1 remote password 2 See Table 5 15 for information about parameter values If you want to specify a restart point see Specifying a Restart Point for a File Transfer Recovery later in this section Example Example 5 19 shows how to restart a file transfer from a local host to a remote host In this example we specify a password for the remote destination host 3787 3213 301 5 41 Restarting a File Transfer RESUME Command gt C gt RESU FILE CHK PASS LMB gt END COMMAND Example 5 19 Restarting a File Transfer from a Local to a Remote Host Using the RESUME Command 5 19 3 Restarting a
178. rocedure To deregister filenames that match a specified file name l 5 Display the DEREGISTER screen from the MAIN MENU or from any other command screen In the Application ID field enter the name of the application In the File name field enter the name of the file to be deregistered In theWild Card Character field enter the wildcard character to be used to deregister a file Transmit TAS then displays a completion message at the bottom of the screen See Table 3 5 for additional information about field values 3 22 3787 3213 301 Deregistering a File DREGISTER Screen Example The registered files associated with application id AAA are File 1 bbc eef Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character BBC EEF File 2 rrr adfgg Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character RRR ADFGG The registered files associated with application id BBG are File 1 abc def Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character ABC DEF File 2 uopt abc ggh Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012
179. s from the field The message remains at the bottom of the screen and you can continue to enter data in the fields 2 3 5 Accessing Error Message Help When you encounter an error the file transfer facility displays an error message at the bottom of the current screen If more information is available about the error message the file transfer facility displays the following field at the bottom of the screen F10 MORE lt gt This field indicates that there is more help available through additional messages Continue to transmit the screen from this position to display the additional messages Example 2 10 shows how to display additional help for an error message 2 14 3787 3213 301 Using On Line Help for Screens POO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name Destination Host Destination File Name Type SYM _ All _ Omm _ Sdf _ Iow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Level Account Project 1 Source 2 Dest Siteinfo Accept Data lt gt FTP5040 Too many choices selected for TYPE Please correct and re transmit F10 MORE lt gt ee Example 2 10 Accessing Error Message Help The file transfer f
180. sfer Situations 2 0 2 0 0 0 eee eee 3 93 4 1 Command Conventions aoaaa anaana aaeeea 4 4 5 1 ALLOCATE Command Keyword Parameter Descriptions 5 2 5 2 CDUP Command Keyword Parameter Descriptions 5 4 5 3 CWD Command Keyword Parameter Descriptions 5 6 5 4 DEALLOCATE Command Keyword Parameter Descriptions 5 9 5 5 DREGISTER Command Keyword Parameter Descriptions 5 12 5 6 FHELP Command Keyword Parameter Description 5 16 5 7 FREGISTER Command Keyword Parameter Descriptions 5 20 5 8 FSITE Command Keyword Parameter Descriptions 5 24 5 9 FSTATUS Command Keyword Parameter Descriptions 5 26 5 10 LOGIN Command Keyword Parameter Descriptions 5 28 5 11 MKD Command Keyword Parameter Descriptions 5 31 5 12 PWD Command Keyword Parameter Descriptions 5 33 5 13 Remove Directory Command Keyword Parameter Descriptions 5 35 5 14 RENAME Command Keyword Parameter Descriptions 5 37 5 15 RESUME Command Keyword Parameter Descriptions 5 39 5 16 TRANSFER Command Keyword Parameter Descriptions 5 47 5 17 Guidelines for Using the Type Translate and Structure Parameters 5 63 3787 3213 301 xi Tables xii 5 18 Sample File Transfer Situations 3787 3213 301 Examples 3 10
181. sion file Max Record Size field e Identify data representation in the transmission file Translate field e Place or replace data in the receiving file Position field e Define transmission data Mode field e Identify the frequency with which checkpoint markers are to be passed Checkpoint mark field e Define data structure in the transmission file Structure field e Create a checkpoint file Checkpoint file name field e Specify information not included in the FTP protocol commands requested by a foreign host siteinfo field 3787 3213 301 Transferring a File TRANSFER Screen There is a default value for each field The default represents the most efficient transfer of data between two OS 2200 hosts Include the same field values when you retrieve a file from a host as when you first sent the file For example when you transfer a data file between your OS 2200 host that uses ASCII data representation and a foreign host that uses EBCDIC representation choose EBCDIC for the Translate field This causes the data to be translated from ASCII to EBCDIC Translate OS 1100 5 Field Non OS 1100 ASCII Ebcdic EBCDIC When you retrieve the file from the other host to your OS 2200 host specifying EBCDIC results in translation of the data from EBCDIC to ASCII Translate OS 1100 4 Field 4 Non OS 1100 ASCII Ebcdic EBCDIC Procedure On the TRANSFER s
182. specified for the source file on the TRANSFER command screen if the file has read write keys 4 Inthe To file password field enter the password you specified for the destination file on the TRANSFER command screen if the file has read write keys 5 If you want to specify where to restart a file transfer see Specifying a Restart Point for a File Transfer Recovery later in this section 6 Transmit the screen The file transfer facility displays a completion message at the bottom of the screen See Table 3 14 for additional information about field values Example Example 3 22 illustrates restarting a file transfer within a local host FO FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name CHK At checkpoint id From file password Clearance Level _ To file password ef Clearance Level _ Accept Data lt gt FTP5095 Command completed successfully a Example 3 22 Restarting a File Transfer within a Local Host Using the RESUME Screen 3 17 2 Restarting a File Transfer Local to Remote Procedure To restart a file transfer from a local host to a remote host 1 Display the RESUME screen from the MAIN MENU or from any other command screen 2 Inthe Checkpoint file name field enter the name of the checkpoint file you specified on the TRANSFER or PUT screen 3787 3213 301 3 63 Restarting a File
183. ssion file STRUCTURE parameter e Define maximum record length in the transmission file MAX _RECORD_SIZE parameter e Place or replace data in the receiving file POSITION parameter e Create a checkpoint file CHECKPOINT parameter 3787 3213 301 Transferring a File TRANSFER Command e Identify the frequency with which checkpoint markers are written to the checkpoint file MARK parameter e Specify information not included in the FTP protocol commands requested by a foreign host SITEINFO parameter There is a default value for each parameter The default represents the most efficient transfer of data between two OS 2200 hosts Include the same parameters when you retrieve a file from a host as when you first sent the file For example when you transfer a data file between your OS 2200 host that uses ASCII data representation and a foreign host that uses EBCDIC representation choose EBCDIC for the TRANSLATE field OS 1100 Translate Non OS 1100 ASCII gt Parameter gt EBCDIC EBCDIC When you transfer the file from your OS 2200 host to the other host specifying EBCDIC causes the data to be translated from ASCII to EBCDIC When you retrieve the file from the other host to your OS 2200 host specifying EBCDIC results in translation of the data from EBCDIC to ASCII OS 1100 Tanelate Non OS 1100 asci lt Parameter lt EBCDIC EBCDIC Format Use
184. st follow these guidelines Many foreign hosts only support file structure STRUCTURE FILE They do not support record structure When you transfer ASCII data files to and from these foreign hosts specify TRANSLATE ASCII and STRUCTURE FILE When the sending file is on your local host TAS does not send the file control information TAS appends a carriage return line feed CRLF sequence at the end of each data image before sending it to the foreign host When the receiving file is on your local host TAS strips off the CRLF sequences before storing the data in your local file Specifying TRANSLATE EBCDIC and STRUCTURE FILE will have the same results as specifying TRANSLATE ASCII and STRUCTURE FILE with the added EBCDIC to ASCII or ASCII to EBCDIC conversion Acting as the server TAS performs this same processing if FTP protocol commands TYPE A or TYPE E and STRU R are received from a foreign host When you transfer an OS 2200 binary data file to a foreign host for processing purposes you have these options You may want TAS to inform the foreign host that you sent the file from a 36 bit word oriented host using the TYPE L 36 command To cause TAS to send the FTP protocol command TYPE L 36 specify STRUCTURE FILE and TRANSLATE L36 Note that many foreign hosts do not accept the TYPE L protocol and other foreign hosts accept TYPE L but cannot convert the data for processing Ifthe file contains 8
185. st Project field if you do not want to use the default 12 If you want to include additional file transfer information for example defining the file type see Including More Specific Information about a File Transfer later in this section 13 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 16 for additional information about field values Example Example 3 31 shows how to transfer an element from a remote host to the local host ES FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host 4 3 0 3 Source File Name SYMELEMENTS SYM Destination Host Destination File Name SYMELEMENTS SYM Type SYM _ All _ Om _ Sdf _ Tow Max Record Size Translate Transparent Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE _ Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Leve Account Project Source BCNET1 SNS _ Dest ha i Siteinfo Accept Data lt gt FTP5095 Command completed successfully pay Example 3 31 Transferring an Element Remote to Local Using the TRANSFER Screen 3 19 4 Transferring a File or Element between Remote Hosts Procedure To transfer a file or element between remote hosts 1 Display the TRANSFER screen from the MAIN MENU or from any other command screen
186. t The default is SYM Transfers the entire file This is the fastest way to transfer a file Do not specify an element name with Type All Transfers an omnibus element in the sending file to the receiving file at the local or a remote host continued 3 74 3787 3213 301 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont ee Type continued Subfield Description Sdf Transfers an SDF file or program element as 8 bit binary data the 9th bit of each byte is meaningless and ignored All file control information is also ignored not transferred This is useful when the data portion of the file or element is usable on the other host TAS uses SDF input output to access the file or element This type is not supported for transfers between OS 2200 hosts Transfers a file or omnibus program element as 8 bit binary data e For a source file the 9th high order bit of the bytes in the last written track of the file is used to determine the end of file The first byte in the last written track with the 9th bit on indicates no more data is to be transferred In the tracks preceding the last written track the 9th bit of each byte is meaningless and ignored For a destination file each eight bits of incoming data are stored in a byte with the 9th bit off zero When the last eight bits are stored the next byte is set to octal 400 9th bit on to indicate the end of file
187. t non OS 2200 that needs to know that the local byte size is 36 bits Position Subfield Description REPLACE Replaces the file on the destination host with the file or element you are transferring The default is REPLACE Adds the file you are sending to the end of the existing file or inserts the element you are sending into the receiving file When you name an element that duplicates an existing element in the receiving file the FILE transfer facility marks the existing element for deletion and replaces it with the new one continued 3 76 3787 3213 301 Transferring a File TRANSFER Screen Table 3 16 TRANSFER Screen Fields cont ee Subfield Description STREAM Use this mode to transfer data in a stream This is the most efficient transfer mode between OS 2200 hosts The default is STREAM You cannot specify a checkpoint file when MODE STREAM Sends data as a series of blocks preceded by a header Use this mode for hosts whose internal file structure is block oriented or when block structure is more efficient for a host Use this mode when transferring data that contains Compressed numerous replications of fillers such as program files This mode is not supported for transfers between OS 2200 hosts Checkpoint mark Specifies how often you want the file transfer facility to write checkpoint ids checkpoint markers in the checkpoint file This field is meaningful only if all of the foll
188. t number in the source 1 Account field if your local account information is not valid for the source host Enter an account number in the destination 2 Account field if your local account information is not valid for the destination host Enter a project identifier in the source 1 Project field if you do not want to use the default Enter a project identifier in the destination 2 Project field if you do not want to use the default If you want to include additional file transfer information for example defining the file type see the section on Including More Specific Information About a File Transfer later in this section Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 16 for additional help with field values Example Example 3 30 shows how to transfer a file from the local host to a remote host 3 82 3787 3213 301 Transferring a File TRANSFER Screen CLAN FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name SDFFILE Destination Host 4 3 0 3 Destination File Name SDFFILE Type SYM _ All _ Omn Sdf _ Iow Max Record Size Translate Transparent Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password L
189. t to change the working directory Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required if a session is not currently active For more information about specifying host ids see Section 1 To specified The name of the path to be changed on a remote foreign host airera Use 1 to 132 alphanumeric characters This field is required Userid The user identifier required to access the remote host This field is optional depending upon the requirements of the remote host Use 1 to 12 alphanumeric characters Password The password as required by the remote host Use 1 to 18 alphanumeric characters Account The number as required by the remote host This field is optional depending upon the requirements of the remote host Use 1 to 12 alphanumeric characters Procedure To change the working directory on the remote host where you want to transfer a file 1 Display the CHANGE WORKING DIRECTORY screen from the MAIN MENU or from any other command screen 2 Ifa session is not already active with the remote host where you want to change the working directory enter the host id in the Host field In the To specified directory field specify the address path on the remote host 4 Enter your userid password and account number for the
190. t was registered NO Does not deregister the filename after a file transfer is received that matches the file name that was registered The default is NO continued 3 50 3787 3213 301 Registering a File for Event Notification REGISTER Screen Table 3 11 REGISTER Screen Fields cont es Save Filename and YES Saves the filename and file transfer status until a Status Status Request command is received NO Does not save the filename or file transfer status The default is NO Control Value This is an octal value which TAS enters in the SETC parameter of the START ECL statement it executes for the even notification runstream This is a 1 to 4 digit field with a leading O and no digit greater than 7 for example 0235 This field is optional Initiate Indicates how to execute the runstream Add using an ADD ECL statement A response is not returned to the initiator of the command until the runstream completes Start using an START ECL statement A response is returned to the initiator of the command as soon as the START is issued 3 14 4 Registering a Filename Procedure To register a filename 1 Display the REGISTER screen from the MAIN MENU or from any other command screen Enter the name of the application or user in the Application ID field Enter the name of the file in the Filename field Enter the name of the runstream in the Runstream field TF wN Transmit The file transfer facility
191. terface Section 2 Getting Started with the Menu Interface Describes how to begin and end a menu interface session and how to access and use the file transfer screens This section also provides instructions for getting on line help for screens Section 3 Using the Menu Interface Describes each file transfer screen and provides detailed step by step procedures to perform the screen functions Section 4 Getting Started with the Command Interface Describes how to begin and end a command interface session and how to use the file transfer commands This section also provides instructions to get on line help for commands Section 5 Using the Command Interface Describes each file transfer command format and provides examples to perform the command functions Appendix A TAS FTPMSG Error Messages File Provides a list of possible messages that can be written to the TAS FTPMSG file on the local host when the file transfer facility is invoked from a user on a remote host file This appendix serves as a reference for error messages appearing in the TAS FTPMSG file 3787 3213 301 About This Guide Results After reading this guide you will e Have a general understanding of how the file transfer facility works e Know how to get on line help for the file transfer facility e Know how to use the menu and command interface to transfer and delete files Related Product Information Note For all manuals use the version
192. th the specified host Screen Figure 3 4 shows the DEALLOCATE screen FON FTP 6R1 DEALLOCATE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt File name Host Userid Password Clearance Level Account Project Accept Data lt gt Neg es Figure 3 4 DEALLOCATE Screen Screen Field Descriptions Table 3 4 describes the fields in the DEALLOCATE screen 3787 3213 301 3 11 Deleting a File DEALLOCATE Screen Table 3 4 DEALLOCATE Screen Fields ee File name The name of the file you want to delete This must be a valid file name for the system on which the file resides The name cannot contain underscores This field is required For more information on specifying file names see Section 1 Host The identifier of the remote host where you want to change the working directory Use 1 to 255 alphanumeric characters If you omit the host identifier the host to which you are currently logged in is used Omit a host id during a session unless you want the current session to be closed and a new session opened This field is required if a session is not currently active For more information about specifying host ids see Section 1 Userid The user identifier as required by the remote host Use 1 to 12 alphanumeric characters Password The password as required by the host where the file resides Use 1 to 18 alphanumeric characters This fiel
193. that matches this saved record NO Does not deregister any filename records The default is no Example Example 5 13 shows how to get saved status 3787 3213 301 Getting File Registration Status FSTATUS Command C gt FSTA USERID ftpuser gt TAS 5R1 0629 1 FTP1170 Warning status removed for FILE gt ABC DEF STATUS 0 Example 5 13 Saved Status Request 3787 3213 301 5 27 Beginning a Session LOGIN Command 5 13 Beginning a Session LOGIN Command Use the LOGIN command to open a session between two hosts While a session is open FPUT and FGET commands move files between hosts If a session is already open when this command is entered the session is closed and a new session is opened Any file transfer that is underway when LOGIN is entered completes before that session is ended You can also open a session by specifying a host id on other FTP commands Refer to Methods of Transferring Files in 1 3 for more information about sessions Note When you issue this command the session remains open See the subsection called Ending under 4 1 for information on how to close a session Command Format LOGIN HOST host id PASSWORD remote password CLEARANCE LEVEL remote clearance level Eae a En cer 4 d ACCOUNT remote account info Keyword Parameters Table 5 10 describes the keyword parameters for the LOGIN command Table 5 10 LOGIN Command Keyword Parameter Descriptions
194. that corresponds to the release level of the product software in use on your system OS 2200 TCP IP Application Services TAS C Language Programming Guide 4173 5135 Describes how to write C Language programs for program callable file transfer applications OS 2200 TCP IP Application Services TAS COBOL Programming Guide 3787 3205 Describes how to write COBOL programs for program callable file transfer and mail transfer applications OS 2200 TCP IP Application Services TAS FORTRAN Programming Guide 3787 3247 Describes how to write FORTRAN programs for program callable file transfer applications and mail transfer applications OS 2200 TCP IP Application Services TAS Implementation and Administration Guide 3787 3221 Describes the major features of this release and provides instructions for installing and verifying TAS OS 2200 TCP IP Application Services TAS Mail Processor User Guide 3787 3239 Describes how to create send and receive messages with other hosts in a TCP IP network This guide provides instructions on how to use the DPS 2200 menu interface and the IPF 1100 command interface OS 2200 Distributed Data Processing DDP PPC DDP F JT Messages Reference Manual 3787 3528 Lists and describes error message codes returned by DDP PPC 3787 3213 301 xix About This Guide Notation Conventions Table 4 1 explains the conventions we use to document the file transfer commands XX 3787 3213 301 Sect
195. that you initiated e Within a local host e From a local to a remote host e From a remote to a local host e Between remote hosts You can also indicate specifically where you want a file transfer to resume Note The file transfer facility uses a checkpoint file to recover a file transfer Therefore you must have specified a checkpoint file name on the TRANSFER GET or PUT screen when you transferred the file If you did not specify a checkpoint file name you cannot restart a file transfer Screen Figure 3 16 shows the RESUME screen FO FTP 6R1 RESUME 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Checkpoint file name At checkpoint id From file password Clearance Level _ To file password Clearance Level _ Accept Data lt gt seee Figure 3 16 RESUME Screen Screen Field Descriptions Table 3 14 describes the fields in the RESUME screen 3787 3213 301 3 61 Restarting a File Transfer RESUME Screen Table 3 14 RESUME Screen Fields ee Checkpoint file name The name of the checkpoint file you specified on the TRANSFER name GET or PUT screen This must be a valid OS 2200 file name This field is required At checkpoint id The identifier of a checkpoint marker listed in the checkpoint file Indicates where you want the transfer to resume For more information about checkpointing see Section 1 and
196. the best match The run stream associated with this file id is then executed If two files have the same comparison value the best match is determined by ranking the file id parts in the following order most important to least important File id Parts In Order Of Importance Qualifier Fillename F Cycle Element Read Key Write Key Version The file that has the higher comparison value for a file id part in the order of importance is considered the best match 3787 3213 301 3 47 Registering a File for Event Notification REGISTER Screen For example if File A and file B both have a total comparison value of 65 File A and file B both have a QUALIFIER part comparison value of 12 File A has a FILENAME part comparison value of 10 and file B has a FILENAME part comparison value of 8 then file A is the best match Example Assume that the file name received on a transfer command is AGCAA BCDHH CCE This is converted to the following file id Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789012345 Character AGCA BCDHH CCE Assume there are the following two previously registered file names File 1 ABCAA BBDBB CCB where B is a wild card File 1 has the following file id Qualifier Name Element Cy Rkey Wkey Elt name Elt Vers Position 123456789012345678901234567890123456789012345678901234567890123456789
197. the host still returns a successful status message even though the command has not been processed Screen Figure 3 1 shows the ALLOCATE command screen OS FTP 6R1 ALLOCATE 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Host Bytes Records Userid Password Account Accept Data lt gt 9 _s__lLLLHmc___z __zA L Figure 3 1 ALLOCATE Screen Screen Field Descriptions Table 3 1 describes the fields in the ALLOCATE screen 3 2 3787 3213 301 Reserving Storage on a Remote Host for the Transferred File ALLOCATE Screen Table 3 1 ALLOCATE Screen Fields es The identifier of the remote host where you want to reserve storage Use 1 to 255 alphanumeric characters For more information about specifying host ids see Section 1 Bytes The number of bytes of storage you want to reserve for the file Size requirements are defined by the remote host This field is required Records The number of records of storage you want to reserve for the file as required by the remote host You must specify a value for the Bytes field even when you specify a value for the Records field Size requirements are defined by the remote host Userid Specifies a userid to access the file on the remote host if required Use 1 to 12 alphanumeric characters Password The password required to access the directory on the remote host This parameter may be optional dependi
198. then displays a completion message at the bottom of the screen Example Example 3 17 shows how to register a filename 3787 3213 301 3 51 Registering a File for Event Notification REGISTER Screen Pe FTP 6R1 REGISTER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Application ID ftpappl Filename TEST File Runstream Start File Element Start Options Control Value Wild Card Character _ One Time Registration yes NO Save Filename and Status yes NO __ Initiate add __ START _ Accept Data lt gt er Example 3 17 Registering a Filename Using the REGISTER Screen 3 14 5 Registering a Filename with a Wildcard Character Procedure To register a filename with a wildcard character Enter the name of the application or user in the Application ID field Enter the filename in the Filename field with a wild card character Enter the runstream in the Runstream field Pw N a Enter the wild card character that was used in the Filename field into the Wild Card Character field 5 Transmit The file transfer facility then displays a completion message at the bottom of the screen See Table 3 11 for additional help on field values Example Example 3 18 shows how to register a filename with a wildcard character 3 52 3787 3213 301 Registering a File for Event Notification REGISTER Screen BOO FTP 6R1 REGISTER 9
199. tructure STRUCTURE FILE They do not support record structure When you transfer ASCII data files to and from these foreign hosts specify TRANSLATE ASCII and STRUCTURE FILE When the sending file is on your local host TAS does not send the file control information TAS appends a carriage return line feed CRLF sequence at the end of each data image before sending it to the foreign host When the receiving file is on your local host TAS strips off the CRLF sequences before storing the data in your local file Specifying TRANSLATE EBCDIC and STRUCTURE FILE will have the same results as specifying TRANSLATE ASCII and STRUCTURE FILE with the added EBCDIC to ASCII or ASCII to EBCDIC conversion Acting as the server TAS performs this same processing if FTP protocol commands TYPE A or TYPE E and STRU R are received from a foreign host When you transfer an OS 2200 binary data file to a foreign host for processing purposes you have these options You may want TAS to inform the foreign host that you sent the file from a 36 bit word oriented host using the TYPE L 36 command 3787 3213 301 3 91 Transferring a File TRANSFER Screen To cause TAS to send the FTP protocol command TYPE L 36 specify STRUCTURE FILE and TRANSLATE L36 Note that many foreign hosts do not accept the TYPE L protocol and other foreign hosts accept TYPE L but cannot convert the data for processing Ifthe file contains 8 bit binary data i
200. uested by the foreign host site 10 Transmit the screen The file transfer facility then displays a completion message at the bottom of the screen See Table 3 16 for additional information about field values Examples Example 3 33 shows how to transfer an omnibus element within the local host Co ser ae FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host Source File Name OMNELEMENTS OMN1 Destination Host Destination File Name OMNELEMENTS OMN2 Type SYM All Omn x Sdf Iow Max Record Size Translate Transparent x Ascii Ebcdic L36 Mode STREAM Block _ Compressed _ T Position REPLACE _ Add _ Structure FILE x Record _ Checkpoint mark Checkpoint file name Userid Password Leve Account Project Source E O E Dest r Siteinfo ccept Data lt gt FTP5095 Command completed successfully NM Example 3 33 Transferring an Omnibus Element within the Local Host Using the TRANSFER Screen In this example you can leave the Translate and Structure fields blank because TRANSPARENT and FILE are the defaults Example 3 34 shows how to transfer a symbolic element from a remote host to a local host 3 88 3787 3213 301 Transferring a File TRANSFER Screen Po St t C SN FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source H
201. vided 3 Transmit the screen Example 2 4 shows how to access the DEALLOCATE screen from the TRANSFER screen Command ___ lt gt field FO FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command DE lt gt Source Host Source File Name Example 2 4 Accessing a Command Screen from Another Command Screen When you transmit this screen the file transfer facility displays the DEALLOCATE screen 2 2 3 Transmitting a Command Screen You must transmit a command screen to process a command You can transmit from any position within the command section of the command screen However the command is processed more efficiently if you transmit from the Accept Data lt gt field Caution If you transmit from the function key section the desired function is executed and information entered in the command section is ignored 3787 3213 301 2 9 Using On Line Help for Screens 2 3 2 3 1 2 3 2 Using On Line Help for Screens Types of Help Available Five types of on line help are available e General help describes the file transfer facility and how to operate it e Screen help describes the purpose of a command and how to execute it e Field help describes an individual field on the current command screen e Error message help provides an explanation for a message you receive e FHELP provides a list of available functions implemented on a s
202. ximum record size less than 7168 bytes Use 1 to 5 digits POSITION REPLACE Replaces the file on the destination host with the file or element you are transferring The default is REPLACE POSITION ADD Adds the file you are sending to the end of continued the existing file or inserts the element you are sending into the receiving file When you name an element that duplicates an existing element for deletion and replaces it with the new one CHECKPOINT file name 3 The name of the file that contains a record of the transfer commands and options and that records checkpoint ids throughout a transfer You must specify a checkpoint file name to use the RESUME command This must be a valid OS 2200 file name The RESUME command lets you restart a file transfer that abnormally terminates You cannot specify a checkpoint file if MODE STREAM MARK 250 Indicates how often you want the file transfer facility to insert checkpoint ids in the checkpoint file The default is every 250 tracks You cannot specify this parameter if MODE STREAM continued 5 54 3787 3213 301 Transferring a File TRANSFER Command Table 5 16 TRANSFER Command Keyword Parameter Descriptions cont MARK continued Specifies how often you want the file transfer facility to insert checkpoint ids in the checkpoint file This parameter is meaningful only when all of the following are true The sending file is on your local host You speci
203. y purposes Using the Message Section The message section e Displays messages from the file transfer facility e Displays on line help information which you request for fields in the command section When you transmit a command the file transfer facility displays e An appropriate completion message e Aninformation message e Anerror message 2 2 2 Accessing Command Screens You can access command screens from e The MAIN MENU e Another command screen Accessing a Command Screen from the MAIN MENU To access a command screen from the MAIN MENU either e Enter a two letter command code at the prompt and transmit e Move the cursor between the angle brackets before the command you want to access and transmit Example 2 2 shows how to access the TRANSFER command screen by entering the two letter command code tr on the MAIN MENU 3787 3213 301 2 7 Using the Menu Interface TLLA FTP 6R1 FILE TRANSFER PROTOCOL 97 08 30 MAIN MENU Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt Move the cursor to the desired command and transmit or Type the desired command code and transmit tr File Transfer lt gt tr Transfer lt gt lo Login lt gt al Allocate lt gt re Resume lt gt ge Get lt gt cp Change to Parent lt gt de Deallocate lt gt pu Put lt gt cd Change Work Dir lt gt rn Rename lt gt cl Close lt gt md Make Dir lt gt fs Fsite lt gt rf Register lt gt pw
204. y then displays a completion message at the bottom of the screen See Table 3 16 for additional information about field values Example Example 3 32 shows how to transfer a file between remote hosts 3787 3213 301 3 85 Transferring a File TRANSFER Screen 3 19 5 3 86 ES FTP 6R1 TRANSFER 97 08 30 Fl Help lt gt F2 Refresh lt gt F3 Exit lt gt F4 Main Menu lt gt Command _ lt gt Source Host HOSTA Source File Name SDFFILE Destination Host UCLA SCI Destination File Name SDFFILE Type SYM _ All _ Om _ Sdf _ Tow Max Record Size Translate Transparent _ Ascii _ Ebcdic _ L36 _ Mode STREAM Block _ Compressed _ Position REPLACE Add _ Structure FILE _ Record _ Checkpoint mark Checkpoint file name Userid Password Leve Account Project Source BCNET1 SNS 10 ST 103 COMMS Dest FTPSL PSK 20 SB 101 DDN Siteinfo Accept Data lt gt FTP5095 Command completed successfully E Example 3 32 Transferring a File between Remote Hosts Using the TRANSFER Screen Including More Specific Information about a File Transfer When you know the characteristics of the source and destination hosts you can e Enter additional fields on the TRANSFER screen to include more specific file transfer information e Transfer a file more efficiently On the TRANSFER screen you can also e Define the sending file or element type Type field e Define maximum record length in the transmis

TCP/IP Application Services (TAS) File Transfer User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents