Re: YA MGCRE RCF?

2022-07-12 Thread Steve Smith
Most code examples in IBM manuals are pretty poor examples of coding, and
I'd think IBM would take more care with them, just because it would
make them look smarter.  Nevertheless, as Charles alluded, they serve their
purpose, and I've found them useful many times.

But I'd never copy them.

sas


On Tue, Jul 12, 2022 at 7:49 PM Charles Mills  wrote:

> Well, a doc writer giving examples has to balance between trivial versus
> overly complex, and has to make certain assumptions about the reader's
> knowledge and environment.
>
> This example is flawed as you indicate but I would find it useful. It at
> least shows the format of TEXT and CONSNAME.
>
> Charles
>
>
> -Original Message-
> From: IBM Mainframe Assembler List [mailto:ASSEMBLER-LIST@LISTSERV.UGA.EDU]
> On Behalf Of Paul Gilmartin
> Sent: Tuesday, July 12, 2022 3:45 PM
> To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
> Subject: Re: YA MGCRE RCF?
>
> Well, that got terribly garbled.  Trying a different way.
>
> On Tue, 12 Jul 2022 10:30:13 -0600, Paul Gilmartin wrote:
> >Do I have cause for an RCF here?
> >
> >In  z/OS 2.5 MVS Programming: Authorized Assembler Services
> Reference, Volume 3 (LLA-SDU)
> >IBM SA23-1374-50
> >
> >I see: MGCRE - Execute form
> >
> DOMTST   CSECT
> R2   EQU   2
>  USING *,R12
>  LAR2,CMD   R2 POINTS TO THE COMMAND AREA
>  MGCRE MF=(E,LAREA),TEXT=(R2),CMDFLAG=(NOHCPY),CONSNAME=MYCON
> CMD  DS0CL6 THE COMMAND AREA
> CMDLEN   DCXL2'4'   LENGTH OF COMMAND
> CMDCOMM  DCCL4'D C 'THE ACTUAL COMMAND
> MYCONDCCL8'CON4'NAME OF ISSUING CONSOLE
> LAREAMGCRE MF=L LIST FORM OF MGCRE
>  END
>
>  It's inconsistent that there is an EQU for R2 but not R12.
>
> The content of R12 is nowhere defined, by e.g. LR R12,R15.
>
> Has this code been tested?
>
> Outside this example, the doc does not mention a need for
> CSECT addressability. Is this generally assumed,
> or must it be asserted for each macro? |
>
> --
> Thanks,
> gil
>


Re: YA MGCRE RCF?

2022-07-12 Thread Charles Mills
Well, a doc writer giving examples has to balance between trivial versus overly 
complex, and has to make certain assumptions about the reader's knowledge and 
environment. 

This example is flawed as you indicate but I would find it useful. It at least 
shows the format of TEXT and CONSNAME.

Charles


-Original Message-
From: IBM Mainframe Assembler List [mailto:ASSEMBLER-LIST@LISTSERV.UGA.EDU] On 
Behalf Of Paul Gilmartin
Sent: Tuesday, July 12, 2022 3:45 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: YA MGCRE RCF?

Well, that got terribly garbled.  Trying a different way.

On Tue, 12 Jul 2022 10:30:13 -0600, Paul Gilmartin wrote:
>Do I have cause for an RCF here?
>
>In  z/OS 2.5 MVS Programming: Authorized Assembler Services
Reference, Volume 3 (LLA-SDU)
>IBM SA23-1374-50
>
>I see: MGCRE - Execute form
>
DOMTST   CSECT
R2   EQU   2
 USING *,R12
 LAR2,CMD   R2 POINTS TO THE COMMAND AREA
 MGCRE MF=(E,LAREA),TEXT=(R2),CMDFLAG=(NOHCPY),CONSNAME=MYCON
CMD  DS0CL6 THE COMMAND AREA
CMDLEN   DCXL2'4'   LENGTH OF COMMAND
CMDCOMM  DCCL4'D C 'THE ACTUAL COMMAND
MYCONDCCL8'CON4'NAME OF ISSUING CONSOLE
LAREAMGCRE MF=L LIST FORM OF MGCRE
 END

 It's inconsistent that there is an EQU for R2 but not R12. 

The content of R12 is nowhere defined, by e.g. LR R12,R15.

Has this code been tested? 

Outside this example, the doc does not mention a need for
CSECT addressability. Is this generally assumed,
or must it be asserted for each macro? |

-- 
Thanks,
gil


Re: YA MGCRE RCF?

2022-07-12 Thread Paul Gilmartin
Well, that got terribly garbled.  Trying a different way.

On Tue, 12 Jul 2022 10:30:13 -0600, Paul Gilmartin wrote:
>Do I have cause for an RCF here?
>
>In  z/OS 2.5 MVS Programming: Authorized Assembler Services
Reference, Volume 3 (LLA-SDU)
>IBM SA23-1374-50
>
>I see: MGCRE - Execute form
>
DOMTST   CSECT
R2   EQU   2
 USING *,R12
 LAR2,CMD   R2 POINTS TO THE COMMAND AREA
 MGCRE MF=(E,LAREA),TEXT=(R2),CMDFLAG=(NOHCPY),CONSNAME=MYCON
CMD  DS0CL6 THE COMMAND AREA
CMDLEN   DCXL2'4'   LENGTH OF COMMAND
CMDCOMM  DCCL4'D C 'THE ACTUAL COMMAND
MYCONDCCL8'CON4'NAME OF ISSUING CONSOLE
LAREAMGCRE MF=L LIST FORM OF MGCRE
 END

 It's inconsistent that there is an EQU for R2 but not R12. 

The content of R12 is nowhere defined, by e.g. LR R12,R15.

Has this code been tested? 

Outside this example, the doc does not mention a need for
CSECT addressability. Is this generally assumed,
or must it be asserted for each macro? |

-- 
Thanks,
gil


YA MGCRE RCF?

2022-07-12 Thread Paul Gilmartin

Do I have cause for an RCF here?

In  z/OS 2.5
MVS Programming: Authorized Assembler Services Reference, Volume 3 (LLA-SDU)
IBM SA23-1374-50

I see: MGCRE - Execute form

|DOMTST CSECT R2 EQU 2 USING *,R12 LA R2,CMD R2 POINTS TO THE COMMAND 
AREA MGCRE MF=(E,LAREA),TEXT=(R2),CMDFLAG=(NOHCPY),CONSNAME=MYCON CMD DS 
0CL6 THE COMMAND AREA CMDLEN DC XL2'4' LENGTH OF COMMAND CMDCOMM DC 
CL4'D C ' THE ACTUAL COMMAND MYCON DC CL8'CON4 ' NAME OF ISSUING CONSOLE 
LAREA MGCRE MF=L LIST FORM OF MGCRE END It's inconsistent that there is 
an EQU for R2 but not R12. The content of R12 is nowhere defined, by 
e.g. LR R12,R15. Has this code been tested? Outside this example, the 
doc does not mention a need for CSECT addressability. Is this generally 
assumed, or must it be asserted for each macro? |


--
Thanks,
gil