
.C Attributes for a Medium Object         

The medium object is only used by the PSM AIX DSS.  The objects are used
by the AIX DSS, to determine the medium dimensions.  The medium-dimensions
contains information that is needed by the printing system.  Any printer
attribute that references a medium object is validated by the AIX DSS to
ensure that the object exists.

The PSF DSS and the BSD DSS do not use or validate medium objects.
Printer attributes that reference medium objects can use any name as long
as the name is within syntax limits.

.nf
   |------------------------------------------------------------------------|
   | Settable Attribute Listing         | Specifiable Attribute Listing     |
   |------------------------------------|-----------------------------------|
   |     descriptor                     | There are no specifiable          |
   |     list-of-manager                | attributes for a medium object.   |
   |     medium-color                   |                                   |
   |     medium-dimensions (AIX)        |                                   |
   |     medium-form-parts              |                                   |
   |     medium-holes-count             |                                   |
   |     medium-sides                   |                                   |
   |     medium-size                    |                                   |
   |     medium-type                    |                                   |
   |     message                        |                                   |
   |------------------------------------------------------------------------|


   |------------------------------------------------------------------------|
   | Table  1-1. Medium Attributes                                          |
   |------------------------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | associated-server                                         |
   |------------|-----------------------------------------------------------|
   | Type       | Non Settable                                              |
   |------------|-----------------------------------------------------------|
   | Explanation| Indicates the name of the server in which this medium     |
   |            | object resides.                                           |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | A text string up to 255 characters that contains the name |
   |            | of the server.  Implicitly set by PSM from the command    |
   |            | argument.  (ServerName:MediumName) when the medium object |
   |            | is created using the pdcreate command                     |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | descriptor                                                |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Explanation| Provides a description of the object.                     |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | A text string up to 4095 characters that describes this   |
   |            | medium object.                                            |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | list-of-managers                                          |
   |------------|-----------------------------------------------------------|
   | Input      | managers                                                  |
   | Synonym    |                                                           |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   | Explanation| List of people that are responsible for the maintenance   |
   |            | of this medium object.                                    |
   |------------|-----------------------------------------------------------|
   | Value Type | Multiple values.                                          |
   |------------|-----------------------------------------------------------|
   | Values     | Any text string up to 255 characters per person that      |
   |            | contains the ID of the person responsible for this medium |
   |            | object.                                                   |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-color                                              |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   | Explanation| Indicates the color of this medium object.                |
   |------------|-----------------------------------------------------------|
   | Value Type | Single Value                                              |
   |------------|-----------------------------------------------------------|
   | Values     | One of the following fixed values:                        |
   |            |                                                           |
   |            | Fixed Value         Input Synonym                         |
   |            | blue                                                      |
   |            | buff                                                      |
   |            | goldenrod                                                 |
   |            | green                                                     |
   |            | pink                                                      |
   |            | transparent         untinted                              |
   |            | white                                                     |
   |            | yellow                                                    |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-dimensions                                         |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Explanation| This is a complex attribute with the following            |
   |            | components:                                               |
   |            |                                                           |
   |            | Component           Value                                 |
   |            | x-dimension         integer in millimeters                |
   |            | y-dimension         integer in millimeters                |
   |------------|-----------------------------------------------------------|
   | Value Type | Single Value                                              |
   |------------|-----------------------------------------------------------|
   | Values     | Two positive real numbers separated by a colon.           |
   |------------|-----------------------------------------------------------|
   | Syntax     | -x "x-value:y-value"                                      |
   |            |                                                           |
   |            | For example: -x "100.8:200.4"                             |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      | o   Supported in and required by AIX DSS.                 |
   | Guidelines | o   Indicates, in millimeters, the x-dimension and        |
   |            |     y-dimension of this medium object.                    |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-form-parts                                         |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   | Explanation| Indicates the number of form parts associated with this   |
   |            | medium object.                                            |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | An integer from 1 to 2147483647.                          |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-holes-count                                        |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate or pdset commands.             |
   |------------|-----------------------------------------------------------|
   | Explanation| Indicates the number of holes (if any), pre-punched in    |
   |            | the medium.                                               |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | An integer from 0 to 2147483647.                          |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-identifier                                         |
   |------------|-----------------------------------------------------------|
   | Type       | Non Settable                                              |
   |------------|-----------------------------------------------------------|
   | Explanation| Uniquely identifies a particular medium object within a   |
   |            | supervisor.                                               |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | Implicitly set by PSM from the argument                   |
   |            | ServerName:MediumName of the pdcreate command.  Either a  |
   |            | text string up to 255 characters that contains the medium |
   |            | name that is unique within a server or one of the         |
   |            | following fixed values:                                   |
   |            |                                                           |
   |            | Fixed Value                   Fixed Value                 |
   |            | iso-a4-white                  iso-a4-colored              |
   |            | iso-a4-transparent            iso-a3-white                |
   |            | iso-a3-colored                iso-a5-white                |
   |            | iso-a5-colored                iso-b4-white                |
   |            | iso-b4-colored                iso-b5-white                |
   |            | iso-b5-colored                jis-b4-white                |
   |            | jis-b4-colored                jis-b5-white                |
   |            | jis-b5-colored                na-letter-white             |
   |            | na-letter-colored             na-letter-transparent       |
   |            | na-legal-white                na-legal-colored            |
   |            | iso-b4-envelope               iso-b5-envelope             |
   |            | iso-c4-envelope               iso-c5-envelope             |
   |            | iso-designated-long-envelope  na-10x13-envelope           |
   |            | na-9x12-envelope              na-number-10-envelope       |
   |            | na-7x9-envelope               na-9x11-envelope            |
   |            | na-10x14-envelope             na-number-9-envelope        |
   |            | na-6x9-envelope               na-10x15-envelope           |
   |            | iso-a0-white                  iso-a1-white                |
   |            | iso-a2-white                  iso-a6-white                |
   |            | iso-a7-white                  iso-a8-white                |
   |            | iso-a9-white                  iso-a10-white               |
   |            | iso-b0-white                  iso-b1-white                |
   |            | iso-b2-white                  iso-b3-white                |
   |            | iso-b6-white                  iso-b7-white                |
   |            | iso-b8-white                  iso-b9-white                |
   |            | iso-b10-white                 jis-b0-white                |
   |            | jis-b1-white                  jis-b2-white                |
   |            | jis-b3-white                  jis-b6-white                |
   |            | jis-b7-white                  jis-b8-white                |
   |            | jis-b9-white                  jis-b10-white               |
   |            | a                             b                           |
   |            | c                             d                           |
   |            | e                             executive                   |
   |            | monarch-envelope              folio                       |
   |            | invoice                       ledger                      |
   |            | quarto                                                    |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-sides                                              |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate and pdset commands.            |
   |------------|-----------------------------------------------------------|
   | Explanation| Indicates the number of printable sides for the medium.   |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | An integer of 1 or 2.                                     |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-size                                               |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate and pdset commands.            |
   |------------|-----------------------------------------------------------|
   | Explanation| Specifies the size of the medium.                         |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | One of the following fixed values:                        |
   |            |                                                           |
   |            | Fixed Value                   Fixed Value                 |
   |            | iso-a0                        iso-a1                      |
   |            | iso-a2                        iso-a3                      |
   |            | iso-a4                        iso-a5                      |
   |            | iso-a6                        iso-a7                      |
   |            | iso-a8                        iso-a9                      |
   |            | iso-a10                       iso-b0                      |
   |            | iso-b1                        iso-b2                      |
   |            | iso-b3                        iso-b4                      |
   |            | iso-b5                        iso-b6                      |
   |            | iso-b7                        iso-b8                      |
   |            | iso-b9                        iso-b10                     |
   |            | na-letter                     na-legal                    |
   |            | iso-b4-envelope               iso-b5-envelope             |
   |            | iso-c4-envelope               iso-c5-envelope             |
   |            | iso-designated-long-envelope  na-10x13-envelope           |
   |            | na-9x12-envelope              na-number-10-envelope       |
   |            | na-7x9-envelope               na-9x11-envelope            |
   |            | na-10x14-envelope             na-number-9-envelope        |
   |            | na-6x9-envelope               na-10x15-envelope           |
   |            | a                             b                           |
   |            | c                             d                           |
   |            | e                             executive                   |
   |            | monarch-envelope              folio                       |
   |            | invoice                       ledger                      |
   |            | quarto                                                    |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | medium-type                                               |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate and pdset commands.            |
   |------------|-----------------------------------------------------------|
   | Explanation| Identifies the medium type.                               |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | One of the following fixed values:                        |
   |            |                                                           |
   |            | Fixed Value                                               |
   |            | stationery                                                |
   |            | transparency                                              |
   |            | envelope                                                  |
   |            | continuous-long                                           |
   |            | continuous-short                                          |
   |            | tab-stock                                                 |
   |            | multi-part-form                                           |
   |            | labels                                                    |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | message                                                   |
   |------------|-----------------------------------------------------------|
   | Type       | Settable with the pdcreate and pdset commands.            |
   |------------|-----------------------------------------------------------|
   | Explanation| Provides a message associated with this medium object.    |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Values     | A text string up to 4095 characters that contains         |
   |            | information about this medium object.                     |
   |------------|-----------------------------------------------------------|
   | Default    | No default.                                               |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|
   |------------|-----------------------------------------------------------|
   | Attribute  | Description                                               |
   |------------|-----------------------------------------------------------|
   | Name       | object-class                                              |
   |------------|-----------------------------------------------------------|
   | Type       | Non Settable                                              |
   |------------|-----------------------------------------------------------|
   | Explanation| Identifies the object class to which this object belongs. |
   |------------|-----------------------------------------------------------|
   | Value Type | Single value.                                             |
   |------------|-----------------------------------------------------------|
   | Default    | medium                                                    |
   |------------|-----------------------------------------------------------|
   | Usage      |                                                           |
   | Guidelines |                                                           |
   |------------|-----------------------------------------------------------|

