HLASM Language Reference

HLASM Language Reference HLASM Language Reference

faculty.cs.niu.edu
from faculty.cs.niu.edu More from this publisher
22.02.2015 Views

CATTR Instruction | statements for the class, the attribute is ignored and diagnostic | message ASMA191W is issued. | If the PART attribute has been specified on the first CATTR statement | for the class, but is not specified on subsequent CATTR statements for | the class, the diagnostic message ASMA155S is issued. | Multiple parts may be defined within a class. | PRIORITY(nnnnn) | The binding priority to be attached to this part. The value must be | specified as an unsigned decimal number and must lie between 0 and | 2 31 −1. An invalid priority is ignored and diagnostic message 'ASMA062E | Illegal operand format xxxxxx' is issued. | The PRIORITY attribute may be specified on the first CATTR instruction for | the part. If the PRIORITY attribute is specified on second and subsequent | CATTR instructions for the part it is ignored and the diagnostic message | ASMA191W is issued. | The PRIORITY attribute is ignored if there is no PART attribute on the | CATTR instruction and the diagnostic message 'ASMA062E Illegal operand | format xxxxxx' is issued. READONLY The text is storage-protected. REFR The text is marked refreshable. RENT The text is marked reenterable. REUS The text is marked reusable. RMODE(24) The text has a residence mode of 24. RMODE(31) The text has a residence mode of 31. RMODE(ANY) The text may be placed in any addressable storage. Refer to the z/OS MVS Program Management: User's Guide and Reference, SA22-7643 for details about the binder attributes. Default Attributes: When you don't specify attributes on the CATTR instruction the defaults are: ALIGN(3),EXECUTABLE,NOTREUS,RMODE(24) The LOAD attribute is the default if neither DEFLOAD nor NOLOAD are specified. Where to Use the CATTR Instruction: Use the CATTR instruction anywhere in a source module after any ICTL or *PROCESS statements. The CATTR instruction must be preceded by a START, CSECT, or RSECT statement, otherwise the assembler issues diagnostic message ASMA190E. 114 HLASM V1R5 Language Reference

CCW and CCW0 Instructions If several CATTR instructions within a source module have the same class name, the first occurrence establishes the class and its attributes, and the rest indicate the continuation of the text for the class. If you specify attributes on subsequent CATTR instructions having the same class name as a previous CATTR instruction, the assembler ignores the attributes and issues diagnostic message ASMA191W. If you specify conflicting attributes on the same instruction, the assembler uses the last one specified. In the following example, the assembler uses RMODE(ANY): MYCLASS CATTR RMODE(24),RMODE(ANY) Syntax Checking Only: If you code a CATTR instruction but don't specify the GOFF or XOBJECT option, the assembler checks the syntax of the instruction statement and does not process the attributes. CCW and CCW0 Instructions The CCW and CCW0 instructions define and generate an 8-byte, format-0 channel command word for input/output operations. A format-0 channel command word allows a 24-bit data address. The CCW and CCW0 instructions have identical functions. If a control section has not been established, CCW and CCW0 will initiate an unnamed (private) control section. ►►──┬────────┬──┬─CCW──┬────────────────────────────────────────────► └─symbol─┘ └─CCW─┘ ►──command_code,data_address,flags,data_count──────────────────────►◄ symbol is one of the following: An ordinary symbol A variable symbol that has been assigned a character string with a value that is valid for an ordinary symbol A sequence symbol command_code is an absolute expression that specifies the command code. This expression's value is right-justified in byte 0 of the generated channel command word. data_address is a relocatable or absolute expression that specifies the address of the data to operate upon. This value is treated as a 3-byte, A-type address constant. The value of this expression is right-justified in bytes 1 to 3 of the generated channel command word. flags is an absolute expression that specifies the flags for bits 32 to 37, and zeros for bits 38 and 39, of the generated channel command word. The value of this expression is right-justified in byte 4 of the generated channel command word. Byte 5 is set to zero by the assembler. Chapter 5. Assembler Instruction Statements 115

CATTR Instruction<br />

| statements for the class, the attribute is ignored and diagnostic<br />

| message ASMA191W is issued.<br />

| If the PART attribute has been specified on the first CATTR statement<br />

| for the class, but is not specified on subsequent CATTR statements for<br />

| the class, the diagnostic message ASMA155S is issued.<br />

| Multiple parts may be defined within a class.<br />

| PRIORITY(nnnnn)<br />

| The binding priority to be attached to this part. The value must be<br />

| specified as an unsigned decimal number and must lie between 0 and<br />

| 2 31 −1. An invalid priority is ignored and diagnostic message 'ASMA062E<br />

| Illegal operand format xxxxxx' is issued.<br />

| The PRIORITY attribute may be specified on the first CATTR instruction for<br />

| the part. If the PRIORITY attribute is specified on second and subsequent<br />

| CATTR instructions for the part it is ignored and the diagnostic message<br />

| ASMA191W is issued.<br />

| The PRIORITY attribute is ignored if there is no PART attribute on the<br />

| CATTR instruction and the diagnostic message 'ASMA062E Illegal operand<br />

| format xxxxxx' is issued.<br />

READONLY<br />

The text is storage-protected.<br />

REFR<br />

The text is marked refreshable.<br />

RENT<br />

The text is marked reenterable.<br />

REUS<br />

The text is marked reusable.<br />

RMODE(24)<br />

The text has a residence mode of 24.<br />

RMODE(31)<br />

The text has a residence mode of 31.<br />

RMODE(ANY)<br />

The text may be placed in any addressable storage.<br />

Refer to the z/OS MVS Program Management: User's Guide and <strong>Reference</strong>,<br />

SA22-7643 for details about the binder attributes.<br />

Default Attributes: When you don't specify attributes on the CATTR instruction<br />

the defaults are:<br />

ALIGN(3),EXECUTABLE,NOTREUS,RMODE(24)<br />

The LOAD attribute is the default if neither DEFLOAD nor NOLOAD are specified.<br />

Where to Use the CATTR Instruction: Use the CATTR instruction anywhere in a<br />

source module after any ICTL or *PROCESS statements. The CATTR instruction<br />

must be preceded by a START, CSECT, or RSECT statement, otherwise the<br />

assembler issues diagnostic message ASMA190E.<br />

114 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!