Performing Administrative Tasks in Batch › Define Statements › The Define Shipment USS Mapping Rule Action › Define Shipment USS Mapping Rule Syntax

Define Shipment USS Mapping Rule Syntax

►►─ DEFine SHIPMent USS MAPping RULe ─────────────────────────────────────────►

 ►─ TO ─ DESTination ─ destination-name ─ DESCription ─ description ──────────►

 ►─ USS HOSt PATh NAMe ─ 'path-value' ────────────────────────────────────────►

 ►─┬─────────────────────────────────────────────────────┬─────────────── . ─►◄
   ├─ MAPS TO ─┬────────────────────────┬─ 'path-value' ─┤
   │           └─ USS REMote PATh NAMe ─┘                │
   └─ EXClude ───────────────────────────────────────────┘

DEFINE SHIPMENT USS MAPPING RULE

Creates or updates a mapping rule between a host USS path name and a remote USS path name.

TO DESTINATION destination-name

Specifies the one- to seven-character name of an existing package shipment destination. Name masking is not supported.

DESCRIPTION description

Describes the USS mapping rule that is being created or updated. The text can be up to 40 characters. Embedded spaces are valid if the text is enclosed in either single or double quotation marks. This clause must be specified when creating a USS shipment mapping rule and is optional on an update.

USS HOST PATH NAME path-value MAPS TO USS REMOTE PATH NAME path-value

Specifies the 1- to 768-character host path name and the 1- to 768-character remote path name. Name masking is supported. If the remote path name is omitted, the EXCLUDE clause is the default mapping rule. The HOST PATH NAME must be specified when creating or updating a mapping rule.

Valid path-values meet the following requirements:

• Must start and end with a forward slash (/). If the starting character is not a slash, a syntax error is issued. If the last character is not a slash, a slash is generated.
• If the path name contains a single quote character, use double quotes to enclose the text. A path name cannot contain both a single and a double quote character.
• If the path name cannot fit on a single statement, the overflow may be specified on subsequent lines. Enclose the first string in single quotes then follow it with a comma to indication that an additional line text exists. The pathname specification can not exceed 14 text string values.

If path-values are masked, then node masking resolutions between Host and Remote rules are resolved from right to left.

The MAPS TO clause can be specified with or without the USS REMote PATh NAMe sub-clause. Both of the following examples are valid:

MAPS TO path-value
MAPS TO USS REMote PATh NAMe path-value 

On an update, if the MAPS TO clause is omitted, the EXCLUDE clause is assumed.

EXCLUDE

Does not transmit the USS outputs from the USS HOST PATH NAME specification. The EXCLUDE clause can only be used if the MAPS TO clause is omitted. The two clauses are mutually exclusive.