.fo off .cs 1 on WMAC Use the WMAC command to download CMS files to the Macintosh. WMAC will download text files, binary files, and binary files in MacBinary format. In order to use WMAC, the Macintosh must be running Term for a modem connection, Mac3270 for a LocalTalk connection, or tn3270 for a TCP/IP connection. .cs 1 off .cs 2 on The format of the WMAC command is: 旼컴컴컴컴컁컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � � � � WMAC � fn ft [fm] [(options...[)]] � � � � � � Options: � � � � � � � � � � � � 쿌scii � 쿍inary � 쿘acbin � � � � 쿘Enu � 쿙oascii � 쿙OBinary � � � � 쿙OMacbin � 쿙OMEnu � 쿛rint � � � � 쿞tdxlate � 쿟ext � 쿟Runcate � � � � � � � � � � � � � � 읕컴컴컴컴켁컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� .cs 2 off .cs 3 on OPERANDS fn specifies the filename of the file to be downloaded. ft specifies the filetype of the file to be downloaded. If the first character of the filetype is a period, a period instead of a space will separate the CMS filename and filetype when they are used to form the Macintosh file name. However, the period will be ignored when searching for a matching CMS file. fm specifies the filemode of the file to be downloaded. When "fm" is omitted or specified as "*", all accessed disks will be searched for a file matching "fn" and "ft". OPTIONS Ascii specifies the file to be downloaded contains plain text. The file will be converted from EBCDIC text in CMS to ASCII text on the Macintosh. Line breaks in the CMS file will become line breaks in the Macintosh file. This is the default type of transfer. Binary specifies the file to be downloaded contains arbitrary binary data. The contents of the file will be downloaded unchanged, with line divisions in the CMS file ignored. Macbin specifies the file to be downloaded contains the binary image of a Macintosh file in MacBinary format. As the file is downloaded, the MacBinary format will be interpreted to restore the original Macintosh file. MEnu specifies that a standard Macintosh file dialog be issued to define the name and location of the downloaded file. This is the default. Noascii NOBinary NOMacbin reset the Ascii, Binary, or Macbin options described above. If an option is set, then reset by a subseuqent option, WMAC behaves as if the option were never used. NOMenu suppresses issuing a standard file dialog on the Macintosh to select the name and destination of the downloaded file. The file will be written to the current disk or folder, using the same name as the CMS file, but with upper case letters translated to lower case. Print causes the specified file to be printed on the printer currently selected on the Macintosh, instead of being downloaded to disk. Formatting on the printer is controlled by the Macintosh program (tn3270, Term, or Mac3270). See the program's documentation for additional information. Stdxlate causes the standard IBM ASCII/EBCDIC translation tables to be used, instead of the modified tables which are the default at Brown. Text specifies that the file to be downloaded contains ASCII text, but that line breaks and trailing blanks are not significant. Blank lines in the CMS file will result in line breaks in the Macintosh file. See "Using the WMAC Command" below for more information about this option. TRuncate specifies that trailing blanks are to be deleted from lines as the file is downloaded. If a line contains only blanks, the downloaded file will contain a null (zero-length) line. USING THE WMAC COMMAND When downloading files, WMAC will treat a CMS file in one of three ways: as a text file, a binary file, or a MacBinary file. Text file processing is the default, and is appropriate for most ordinary files. Downloading in this mode causes EBCDIC text to be translated to ASCII text on the Macintosh, and causes line breaks to be preserved. Binary mode, invoked by the Binary option, causes the data in the CMS file to be downloaded completely unchanged. No translation is performed, and line breaks in the CMS file are ignored. This mode is approriate when transferring a file in an application-specific format between different computers. For example, it could be used to download a MicroSoft Word file which had been uploaded in binary mode from an IBM PC. In general, if the file to be downloaded contains unreadable characters, and it is not in MacBinary format (see below), then it should be downloaded using binary mode. The third mode, MacBinary, is invoked by the Macbin option. This mode is used to download files which contains the data, resources, and control information for a Macintosh file, encoded in the standard MacBinary format. In CMS, a MacBinary file usually contains "BIN" as all or part of its filetype, and has a record length which is a multiple of 128. When files are downloaded in MacBinary mode, the MacBinary format is decoded in order to recreate the original Macintosh file, including its icon, and other attributes. When WMAC is downloading a text file, it ordinarily inserts line breaks into the Macintosh file wherever they appear in the CMS file. Line breaks are approriate for many Macintosh applications, but are interpreted by word processing programs to indicate the start of a new paragraph. Use of the Text option will cause WMAC to convert the CMS file to the proper format for Macintosh word processing. With this option, line breaks and trailing blanks in the CMS file are ignored. Line breaks will be inserted in the Macintosh file only when blank lines appear in the CMS file. In general, WMAC will attempt to convert what appear to be paragraphs in the CMS file to paragraphs in the word processing file. USAGE NOTES 1) If a file transfer does not begin after the WMAC command is entered, either file transfer is not enabled in the Macintosh program (applies to Term only), or the communication path between the Macintosh and the mainframe does not support a feature WMAC requires (applies to Term and tn3270). For Term, if a 3270 emulator is being used, it must support 7171 transparent I/O or its equivalent. For tn3270, the mainframe Telnet server must support 3270 extended data streams. To resume the terminal session, press Enter several times, until WMAC responds with the error message "Retry count exceeded". 2) When downloading all but MacBinary files, WMAC preserves the date the CMS file was last written. The date is used to set both the creation and last modified dates of the Macintosh file. For a MacBinary file, the creation and last modified dates are set from the values found in the file. 3) WMAC only writes to the data fork of Macintosh files, except when downloading a MacBinary file. For MacBinary files, both the data and resource forks are decoded and written. RESPONSES Enter ABORT, CONTINUE, or SUBSET This response is generated when the user chooses "Interrupt Transfer" on the Macintosh. By entering one of the three allowed responses, the use can abort the file transfer, resume the transfer, or enter CMS SUBSET. If CMS SUBSET is entered, the file transfer will resume upon returning from SUBSET. OTHER MESSAGES AND RETURN CODES DMSWMC002E File 'fn ft fm' not found. RC=28 DMSWMC003E Invalid option 'xxxxxxxx', RC=24 DMSWMC004E Mac error nnnn opening 'fileid'. RC=100+Mac return code DMSWMC005E Mac file 'fileid' already exists. RC=100+Mac return code DMSWMC006E Error ...... from Mac write. RC=100+Mac return code DMSWMC007E Retry count exceeded. RC=256 DMSWMC008I nnnnnn block retransmission(s). DMSWMC009E Error nnnnnn from Mac close. RC=100+Mac return code DMSWMC010E Error from CP "SET" command. RC=return code from CP DMSWMC010E Error from CP "TERM" command. RC=return code from CP DMSWMC010E Remote system type is unknown. RC=36 DMSWMC011E This version of Mac3270 (nn.nn) does not support file transfer. RC=36 DMSWMC011E Transfer aborted by used. RC=100+Mac return code DMSWMC012E This version (nn.nn) of Mac3270 or Term does not support the requested transfer type. RC=36 DMSWMC013E File transfer cancelled by user. RC=24 DMSWMC014E File 'fn ft fm' is not in MacBinary format. RC=32 DMSWMC054E Incomplete fileid specified. RC=24 DMSWMC066E 'ASCII' and 'BINARY' or 'MACBIN' are conflicting options. RC=24 DMSWMC069E Disk 'mode' not accessed. RC=36 DMSWMC104S Error 'nnnnn' reading file 'fn ft fm' from disk. RC=100 DMSWMC109S Virtual storage capacity exceeded. RC=104 .cs 3 off