.im staffset
.* .im cmdset         ;.cm not needed with staffset for script 3.5
.ur .cp &$trigger
.cs 8 include         ;.cm use .cs 8's for parts NOT wanted in HELP
.cs 9 ignore          ;.cm don't mess with .cs 9's -- HELP needs them
...helpim             ;.cm imbed for HELP starts here (line 6)
.cs 9 on
.br;.li .fo off
.br;.li .cs 1 on
.br
.cs 9 off
.br;.bd on
.head2 'WMAC'
.bd off
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 9 on
.br;.li .cs 1 off
.br;.li .cs 2 on
.br
.cs 9 off
The format of the WMAC command is:
.br;.* xxx Insert $boxol, $boxolo, $boxbb, or $boxbbo after this line.
.* $boxolo
.sp 2
.tb 14
.ur .bx 1 12 &sysll
.sp
.ur &$vert.^WMAC#fn ft &$lbr.fm&$rbr.^^^&$lbr.(options...&$lbr.)&$rbr.&$rbr.
.sp 1
.tb 14   18 30   33 45   48 60
.us #Options!:
.ur ##&$ulc.#&$urc.#&$ulc.#&$urc.#&$ulc.#&$urc.
.br
##&$vert.Ascii#&$vert. #&$vert.Binary#&$vert. #&$vert.Macbin#&$vert.
.br
##&$vert.MEnu#&$vert. #&$vert.Noascii#&$vert. #&$vert.NOBinary#&$vert.
.br
##&$vert.NOMacbin#&$vert. #&$vert.NOMEnu#&$vert. #&$vert.Print#&$vert.
.br
.ur ##&$vert.Stdxlate#&$vert.#&$vert.Text#&$vert.#&$vert.TRuncate#&$vert.
.br
.ur ##&$llc.#&$lrc.#&$llc.#&$lrc.#&$llc.#&$lrc.
.br
.* xxx replace with $opt
.sp 1
.bx off
.br
.cs 9 on
.br;.li .cs 2 off
.br;.li .cs 3 on
.br
.cs 9 off
.br;.cp 7;.sk 2;.uc Operands;.sk 1
.tentry 'fn' 10
specifies the filename of the file to be downloaded.
.tentry '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.
.tentry '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".
.tend
.br;.cp 7;.sk 2;.uc Options;.sk 1
.tentry '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.
.tentry '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.
.tentry '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.
.tentry 'MEnu'
specifies that a standard Macintosh file dialog be issued to
define the name and location of the downloaded file.  This is
the default.
.tentry 'Noascii'
.tentry 'NOBinary'
.tentry '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.
.tentry '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.
.tentry '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.
.tentry 'Stdxlate'
causes the standard IBM ASCII/EBCDIC translation tables to be
used, instead of the modified tables which are the default
at Brown.
.tentry '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.
.tentry '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.
.tend
.br;.cp 7;.sk 2;.uc Using the WMAC Command;.sk 1
.pp
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.
.pp
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.
.pp
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.
.pp
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.
.br;.cp 7;.sk 2;.uc Usage Notes;.sk 1
.seq 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".
.seq
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.
.seq
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.
.seq end
.br;.cp 7;.sk 2;.uc Responses;.sk 1
.fo off
Enter ABORT, CONTINUE, or SUBSET
.fo on
.sk 1
.in +10
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.
.in -10
.br;.cp 7;.sk 2;.uc Other Messages and Return Codes;.sk 1
.exam
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
.exam end
.cs 9 on
.br;.li .cs 3 off
.br
.cs 9 off