Edit macro QHELP@ Edit macro QHELP@ Author: David McRitchie formatted on 1995/04/01 06:54 for assistance contact: D. McRitchie DMcRitchie@hotmail.com -------------------------------------------------------------------------------- Macro name. QHELP@ users. TSO users type. REXX Edit Macro resides in SYS1.TSOCLIST -------------------------------------------------------------------------------- QHELP@ Support macro for QHELP -------------------------------------------------------------------------------- related QHELP, HELP, CLIST, PROC -------------------------------------------------------------------------------- The QHELP@ macro is in in support of QHELP, which was previously de- scribed as follows: QHELP will place TSO HELP information into a dataset which will be placed into PDF EDIT. The advantage is that the user may then use normal PDF edit commands to examine the content, specifically the fol- lowing options are available in EDIT. 1. Use of the FORWARD and BACKWARD PF keys. Simply using HELP allows a forward direction only. 2. Ability to use FIND. 3. Ability to use FIND ALL after using EXCLUDE ALL 4. Cut and Paste ability using EDIT. The source of the HELP information will depend on what your SYSHELP ddname is. SYSHELP is comprised of such datasets as: SYS1.HELP SYS1.TSOHELP SYS6.IOF.HELP SYS1.DSNHELP SYS6.APEX.HELP -------------------------------------------------------------------------------- QHELP commandname QHELP clistname -- some clists do have HELP -------------------------------------------------------------------------------- Examples ===> TSO QHELP allocate equivalent to ===> TSO HELP allo- cate ===> TSO QHELP vpsprint equivalent to ===> TSO HELP vpsprint ===> TSO QHELP printoff equivalent to ===> TSO HELP printoff ===> TSO QHELP equivalent to ===> TSO HELP The equivalent TSO command is what is SYSOUT TRAPPED by the REXX exe- cute. A corresponding macro (also REXX) is used for EDIT it is named QHELP@. EDIT---- IS03.QHELP.LIST ----------- 01.00 - COLUMNS 001 124 QHELP-- TSO HELP MATERIAL placed into edit for easier viewing COMMAND ===> SCROLL ===> CSR ****** **************************** TOP OF DATA ********************** 000001 000002 COMMAND INVOKING QHELP@ EXECUTE, MACRO ===> QHELP 000003 EQUIVALENT TO TRAPPED OUTPUT ===> TSO HELP 000004 000005 LANGUAGE PROCESSING COMMANDS: 000006 000007 ASM INVOKE ASSEMBLER PROMPTER AND ASSEMBLER F COMPILER. 000008 CALC INVOKE ITF:PL/1 PROCESSOR FOR DESK CALCULATOR MODE. 000009 COBOL INVOKE COBOL PROMPTER AND ANS COBOL COMPILER. 000010 FORT INVOKE FORTRAN PROMPTER AND FORTRAN IV G1 COMPILER. 000011 000012 PROGRAM CONTROL COMMANDS: 000013 000014 CALL LOAD AND EXECUTE THE SPECIFIED LOAD MODULE. 000015 LINK INVOKE LINK PROMPTER AND LINKAGE EDITOR. 000016 LOADGO LOAD AND EXECUTE PROGRAM. 000017 RUN COMPILE, LOAD, AND EXECUTE PROGRAM. 000018 TEST TEST USER PROGRAM. 000019 TESTAUTH TEST APF AUTHORIZED PROGRAMS. 000020 000021 DATA MANAGEMENT COMMANDS: 000022 000023 ALLOCATE ALLOCATE A DATA SET WITH OR WITHOUT AN ATTRIBUTE 000024 LIST OF DCB PARAMETERS. Internal Aspects Internal aspects describes how the edit macro(macro/clist/exec) func- tions. This information is particularly useful to someone who may need to design a similarly functional edit macro. It may also provide additional insight to the user. 1. This is a REXX execute invoked by QHELP. 2. Capitals are turned off, BOUNDS are removed, AUTOSAVE ON. 3. Variable QHELP saved by QHELP is obtained and prefixed with the word HELP. 4. Some additional text is added at beginning. 5. Lines are trapped when HELP xxxx is issued. 6. Any line containing double quotes has the double quotes translated to a superficial character (x'08'). 7. Lines are placed out to dataset in edit. 8. Superficial character (x'08') is translated back to double quotes.