Programming with Reflection

image\rwnprg32.gif VMS Host File Attributes

 

The following table shows the valid VMS host file attributes you can specify in the Attributes argument to the WRQSendFile method. The Attributes argument takes a string value, and therefore must be enclosed in quotation marks. Multiple attributes are separated by a space.

 

Attribute

Values

Meaning/Syntax Example

OWNER_UIC

<Owner User
Identification
Code (UIC)>

UIC for alternate owner of file.

"/OWNER_UIC=[1,1]"
"/OWNER_UIC=FRED"

 

 

 

PROTECTION

SYSTEM, OWNER,
GROUP, WORLD

Alternate protection for destination file¾R(ead), W(rite) E(xecute), and D(elete) protection can be specified for SYSTEM, OWNER, GROUP, and WORLD.

"/PROTECTION=(GROUP:RWE,WORLD:WE)"

 

 

 

ALLOCATION

<numeric value>

Number of blocks initially allocated for the file at the time of creation. By default, or if you specify a value of 0, the entire file is preallocated.

"/ALLOCATION=(10)"

 

 

 

OPTIONS

<keyword>

 

 

BEST_TRY_CONTIGUOUS

Create contiguous file if possible.

 

CONTIGUOUS

Create contiguous file; transfer fails if not possible.

"/OPTIONS=(CONTIGUOUS)"

 

 

 

ATTRIBUTES

<keyword>

 

 

CARRIAGE_RETURN

Carriage-return carriage control.

 

FORTRAN

FORTRAN carriage control.

 

NONE

No carriage control.

 

PRINT

Print carriage control.

 

BLOCK_SPAN

Records are allowed to cross block boundaries.

 

NOBLOCK_SPAN

Records are not allowed to cross block boundaries.

"/ATTRIBUTES=(FORTRAN)"

 

 

 

FORMAT

FIXED

Fixed-size record format.

 

STREAM

Stream record format.

 

STREAM_CR

Stream carriage return record format.

 

STREAM_LF

Stream linefeed record format.

 

UNDEFINED

Undefined record format.

 

VARIABLE

Variable-length record format.

 

VFC

Variable-length with fixed-length control records. Required with /ATTRIBUTES=(PRINT). Set DISABLE-TRANSLATION to YES if you're using this option to create host ASCII files.

"/FORMAT=(VFC)"

 

 

 

SIZE

<numeric value>

Maximum record size.

"/SIZE=(100)"

 

 

 

For ASCII file transfers to a VMS host, the following defaults apply:

· variable-length records

· carriage-return carriage control

· no maximum record length

· default file protection

For BINARY and IMAGE transfers to a VMS host, the following defaults apply:

· fixed-length records

· no carriage control

· 512-byte records

· default file protection

 

image\jump.gif Example

image\popup.gif Related Topics