Skip to content

Commit da18545

Browse files
committed
update README
1 parent b51061d commit da18545

File tree

1 file changed

+32
-13
lines changed

1 file changed

+32
-13
lines changed

execs/README.md

Lines changed: 32 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The following EXECs for z/VM are in this directory:
1919
| GREP EXEC | Search for patterns in files |
2020
| HEAD EXEC | Output the first part of files |
2121
| HISTORY EXEC | Display list of commands previously run |
22-
| MAN EXEC | Give help on CMS/CP/XEDIT commands |
22+
| MAN EXEC | Give help on CMS/CP/XEDIT/TCPIP/REXX commands |
2323
| MKARCZCT EXEC | Create the VMARC file with all EXECs inside |
2424
| QA EXEC | Run QUERY ACCESSED |
2525
| RFN EXEC | Rename file changing only file name |
@@ -48,22 +48,23 @@ PIPE < VMARC MODULE A | deblock cms | > VMARC MODULE A
4848
```
4949

5050
Then:
51-
- Download ``ZVMTOOLS.VMARC`` to your workstation.
51+
- Download ``ZVMEXECS.VMARC`` to your workstation.
5252
- Get it to z/VM in binary, either with FTP (using ``bin``, ``quote site fix 80``, then ``put ZVMTOOLS.VMARC``), or using another tool such as ``IND$FILE``.
5353
- Unpack it:
5454

5555
```
56-
vmarc unpk zvmtools.vmarc
56+
vmarc unpk zvmexecs.vmarc
5757
```
58-
All the files should now be accessible.
58+
All the files should now be accessible on your ``A`` disk.
5959

6060
## Installation through Linux
61-
To install the tools using Linux, perform the following steps:
61+
To install the tools using Linux, the VMARC file is not used.
62+
Perform the following steps:
6263

6364
- Clone it from github:
6465

6566
```
66-
$ git clone https://github.com/mike99mac/zvm-tools
67+
$ git clone https://github.com/openmainframeproject/zvm-community-tools
6768
```
6869

6970
- Change to the new directory and copy the tools to z/VM with ``ftp`` or ``IND$FILE``.
@@ -379,20 +380,38 @@ Where: 'filter' is an optional search filter
379380
```
380381

381382
Hooks must be added to trap logon and logoff time. Perform the following steps:
382-
- Call the MYLOGON EXEC at logon time.
383+
- Call the MYLOGON EXEC at logon time from your PROFILE EXEC.
383384
```
384385
tail -3 profile exec
385386
386387
'SYN SYN' /* set synonyms */
387388
'EXEC MYLOGON' /* save logon time to history */
388389
'SP CONS START TO' userid() /* spool console */
389390
```
390-
391-
- Call MYLOGOFF at logoff time. Setting this in the ``SYN SYNONYM`` file sets LOGOFF to call it. If you logoff with ``#CP LOGOFF`` MYLOGOFF will not be called and you lose the command history for that session.
392-
```
393-
tail -2 syn synonym
394-
MYLOGOFF LOG
395-
HISTORY HIS
391+
- The HISTORY command is added to SYN SYNONYM so just ``HIS`` or ``HIST`` will give you your history.
392+
```
393+
tail -1 syn synonym
394+
HISTORY HISTORY 3
395+
```
396+
- Create a ``LOG EXEC`` that sends the retrieve buffers to the file ``COMMAND HISTORY A``. You must remember to type just ``LOG`` to logoff so it is called. If you type ``#CP LOGOFF`` it will not be called and you lose the command history for that session. Here is a sample:
397+
```
398+
/*-------------------------------------------------------------------*/
399+
/* LOG EXEC - save command history, add timestamp then logoff */
400+
/*-------------------------------------------------------------------*/
401+
parse arg args
402+
403+
/* add list of commands for this session to command history */
404+
'PIPE CP QUERY RETRIEVE BUFFERS', /* get command history */
405+
'| NLOCATE "Position Contents"', /* remove header */
406+
'| SPECS 10-*', /* remove position column */
407+
'| TRANSLATE', /* fold to upper case */
408+
'|>> COMMAND HISTORY A' /* append to history file */
409+
410+
/* add logoff timestamp, then log off */
411+
dashes = "--------------------"
412+
line = "#" dashes "LOGOFF:" DATE('N') TIME('N') dashes
413+
'EXECIO 1 DISKW COMMAND HISTORY A (FINIS STRING' line
414+
'CP LOGOFF' args /* logoff with any args */
396415
```
397416

398417
Examples:

0 commit comments

Comments
 (0)