z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

1. . A character in the format string, in any context other than a flag of a
conversion specification, is treated as an ordinary character that is copied to
the output.
2. In addition to the escape sequences \\,\a, \b, \f, \n, \r, \t, and \v, the escape
sequence \ddd, where ddd is a one-, two-, or three-digit octal number, is
written as a byte with the numeric value specified by the octal number.
3. Output from the d or u conversion specifiers is not preceded or followed with s
not specified by the format operand.
4. Output from the o conversion specifier is not preceded with zeros that are not
specified by the format operand.
5. The sequence (keyword) can occur before a format conversion specifier. The
conversion argument is defined by the value of keyword. The following
keywords are supported:
Any of the Field Name entries in ustar Header Block and Octet-Oriented cpio
Archive Entry. The implementation supports the cpio keywords without the
leading c_ in addition to the form required by Values for cpio c_ mode Field.
Any keyword defined for the extended header in pax Extended Header.
Any keyword provided as an implementation-defined extension within the
extended header defined in pax Extended Header. For example, the sequence
″%(charset)s″ is the string value of the name of the character set in the
extended header.
To ensure proper data display be sure to use the proper conversion specifier
character for the field being displayed for numeric data. For example, the size
field on z/OS systems id often a long long data type. Attempting to display the
size field using a conversion specifier for a smaller data type, for example %d,
will result in a zero being displayed instead of the contents of the size field.
The result of the keyword conversion argument is the value from the applicable
header field or extended header, without any trailing NULs. All keyword values
used as conversion arguments are translated from the UTF -8 encoding to the
character set appropriate for the local file system, user database, and so on,
as applicable.
6. . An additional conversion specifier character, T, is used to specify time
formats. The T conversion specifier character can be preceded by the
sequence (keyword=subformat), where subformat is a date format as defined
by date operands. The default keyword is mtime and the default subformat is:
%b %e %H:%M %Y
7. An additional conversion specifier character, M, is used to specify the file mode
string as defined in ls Standard Output. If (keyword) is omitted, the mode
keyword is used. For example, %.1M writes the single character corresponding
to the entry type field of the ls -l command.
8. An additional conversion specifier character, D, is used to specify the device
for block or special files, if applicable, in an implementation-defined format the
major and minor devices for character special files, in the format
″devmajor,devminor″. If not applicable, and (keyword) is specified, then this
conversion is equivalent to %(keyword)u. If not applicable, and (keyword) is
omitted, then this conversion is equivalent to .
9. An additional conversion specifier character, F, is used to specify a path name.
The F conversion character can be preceded by a sequence of
comma-separated keywords:
(keyword[,keyword] ... )
pax
Chapter 2. Shell command descriptions 497