bdfp1m2kProgramming Concepts and Reference

DBSPA-Create Work Space

Use this function to obtain and initialize work space linked to the SW00SR slot for a subfile. This space is available while the subfile is open.

Format




REF=dsectvv
specifies the file or subfile that you want to access, where dsectvv is the DSECT name and an optional 2-character version.

REF=refname
specifies the file or subfile that you want to access, where refname is a label that references the DSECT name in one of the following formats:

refname
is the label of an 8-byte field that contains the 6-byte DSECT name and an optional 2-character version.

A/refname
is the label of a 4-byte field that contains the storage address of the DSECT name and an optional 2-character version.

FILE=dsect
specifies the file or subfile that you want to access, where dsect is the DSECT name.

SPACE
allocates work space for an open subfile and initializes the work space to X'00'

SPACEB
allocates work space for an open subfile and initializes the work space to X'40'

SPACEF
allocates work space for an open subfile and initializes the work space to a specified character.

space
is the number of bytes of space that you want, which can be a maximum of 3952 bytes. Specify one of the following:

If you request a zero amount of space, the DBSPA macro releases any space that was previously allocated for this subfile.

spacereg
is the register in which you want the base address of the work space loaded.

fillchr
is the character you want to use to initialize the work space. Specify one of the following:

Entry Requirements

None.

Normal Return

The address of the space that the TPFDF product has provided. The TPFDF product also loads this address into field SW00WKA in the SW00SR slot.

Error Return

None.

Programming Considerations

Examples

Related Macros

DBOPN-Open a Subfile.