OMVS ALARM | NOALARM
AUTOSCROLL | NOAUTOSCROLL
CONVERT(character_conversion_table)
DBCS | NODBCS
DEBUG(NO | YES | EVENT | DATA)
ECHO | NOECHO
ENDPASSTHROUGH(ATTN | CLEAR | CLEARPARTITION |
ENTER | NO | PA1 | PA3 | PF1 | PF2 | PF3 … PF24 | SEL)
ESCAPE('escape-characters')
LINES(n)
PFn
(ALARM | NOALARM |
AUTOSCROLL | NOAUTOSCROLL |
BACKSCR |
BOTTOM |
CLOSE |
CONTROL |
ECHO | NOECHO |
FWDRETR |
HALFSCR
HELP |
HIDE | NOHIDE |
NEXTSESS |
NO |
OPEN |
PFSHOW | NOPFSHOW |
PREVSESS |
QUIT |
QUITALL |
REFRESH |
RETRIEVE
RETURN |
SCROLL |
SUBCOMMAND |
TOP |
TSO )
PFSHOW | NOPFSHOW
RUNOPTS('LE/370-runtime-options')
SESSIONS(n)
SHAREAS | NOSHAREAS
WRAPDEBUG(n)
Use the OMVS command to invoke the z/OS shell. You can select options on the OMVS command to customize aspects of the shell interface, such as the function keys.
After you are working in a shell session, you can switch to subcommand mode, return temporarily to TSO/E command mode, or end the session by exiting the shell.
Command format | What it does |
---|---|
OMVS CONV((BPXFX111)) | See Note 1. |
OMVS CONV('SYS1.XXXX') | Looks for SYS1.XXXX(FSUMQ000). See Note 2. |
OMVS CONV('SYS1.XXXX(BPXFX111)') | Looks for SYS1.XXXX(BPXFX111) |
OMVS CONV(XXXX) | Looks for prefix.XXXX(FSUMQ000) |
OMVS CONV(XXXX(BPXFX111)) | Looks for prefix.XXXX(BPXFX111) |
Note:
|
CONVERT((BPXFX450))
Shell and Utilities locale | 3270 code page | Shell code page | Conversion table | Default escape character |
---|---|---|---|---|
De_CH.IBM-500 | IBM-500 | IBM-500 | BPXFX450 | § |
De_DE.IBM-273 | IBM-273 | IBM-273 | BPXFX473 | § |
De_DK.IBM-277 | IBM-277 | IBM-277 | BPXFX477 | ¤ |
En_GB.IBM.285 | IBM-285 | IBM-285 | BPXFX485 | ‾ (the overline character) |
En_JP.IBM-1027 | IBM-1047 | IBM-1047 | BPXFX100 | ¢ |
En_US.IBM-037 | IBM-037 | IBM-037 | BPXFX437 | ¢ |
En_US.IBM-1047(For APL terminals) | IBM-037 | IBM-1047 | BPXFX211 | ¢ |
En_US.IBM-1047 | IBM-037 | IBM-047 | BPXFX111 | ¢ |
Es_ES.IBM-284 | IBM-284 | IBM-284 | BPXFX484 | ¨ |
Fi_FI.IBM-278 | IBM-278 | IBM-278 | BPXFX478 | § |
Fr_BE.IBM-500 | IBM-500 | IBM-500 | BPXFX450 | § |
Fr_CA.IBM-037 | IBM-037 | IBM-037 | BPXFX437 | ¢ |
Fr_CA.IBM-1047 | IBM-037 | IBM-1047 | BPXFX111 | ¢ |
Fr_CH.IBM-500 | IBM-500 | IBM-500 | BPXFX450 | § |
Fr_FR.IBM-297 | IBM-297 | IBM-297 | BPXFX497 | § |
Is_IS.IBM-871 | IBM-871 | IBM-871 | BPXFX471 | ¨ |
It_IT.IBM-280 | IBM-280 | IBM-280 | BPXFX480 | § |
Ja_JP.IBM-939 | IBM-939 | IBM-939 | BPXFX100 | ¢ |
Ja_JP.IBM-1027 | IBM-1027 | IBM-1027 | BPXFX100 | ¢ |
Nl_BE.IBM-500 | IBM-500 | IBM-500 | BPXFX450 | § |
Nl_NL.IBM-037 | IBM-037 | IBM-037 | IBM-037 | ¢ |
Nl_NL.IBM-1047 | IBM-037 | IBM-1047 | BPXFX111 | ¢ |
No_NO.IBM-277 | IBM-277 | IBM-277 | BPXFX477 | ¤ |
Pt_PT.IBM-037 | IBM-037 | IBM-037 | BPXFX437 | ¢ |
Pt_PT.IBM-1047 | IBM-037 | IBM-1047 | BPXFX111 | ¢ |
Sv_SE.IBM-278 | IBM-278 | IBM-278 | BPXFX478 | § |
Xx_XX.IBM-1047 | IBM-1047 | IBM-1047 | BPXFX100 | ¢ |
Restriction: OMVS supports only code pages 939, 1027, and 1047 on DBCS. The null character conversion table (BPXFX100) should be used with DBCS terminals. (It is the default.)
Also, the ddname for the OMVS debug data set is always SYSFSUMO.
With some terminal connections, the <ATTN> key may not be available.
In general, the provider of the TSO/3270 application needs to tell the user whether <PA1>, <ATTN>, or <CLEAR> can be used for ENDPASSTHROUGH.
You can enter a string up to eight escape characters, enclosed in single quotes with no space between them. (Do not use nonprintable EBCDIC characters.)
The default escape character depends on the character conversion table being used. (See Table 2 for a list of default characters and the conversion tables they are used with.) To enter <Ctrl-D>, for example, type in ød or øD in the input area.
If the last character in the input area is one of the escape characters, the <newline> character normally appended to the input data is suppressed. For example, to enter only a <Ctrl-Q> with no final <newline>, type the string øQø in the input area, and press <Enter>.
The label for this PF key (in the PF key lines at the bottom of the screen) shows up as either ALARM or NOALARM, depending on the current toggle setting. If it is ALARM, pressing this PF key turns the alarm on. If it is NOALARM, pressing this PF key turns the alarm off.
The label for this PF key (in the PF key lines at the bottom of the screen) shows up as either AUTOSCROLL or NOAUTOSCROLL, depending on the current toggle setting. If it is AUTOSCROLL, pressing this PF key turns the autoscroll function on. If it is NOAUTOSCROLL, pressing this PF key turns the autoscroll function off.
If you first move the cursor into the output area, the line with the cursor becomes the top line.
The label for this PF key (in the PF key lines at the bottom of the screen) shows up as either ECHO or NOECHO, depending on the current toggle setting. If it is ECHO, pressing this PF key allows the current shell command to hide or unhide the OMVS command input area. If it is NOECHO, pressing this PF key prevents the current shell command from hiding or unhiding the OMVS input area.
To run a subcommand without switching to subcommand mode, type the subcommand at the command line and then press the function key. You can enter the OMVS subcommands at the command line when you are in subcommand mode.
To run a TSO/E command without suspending the shell session or subcommand mode, type the command at the command line and then press the function key. When the command completes, you can continue working in the shell session or subcommand mode.
PF1(HELP)
PF2(SUBCOMMAND)
PF3(RETURN)
PF4(TOP)
PF5(BOTTOM)
PF6(TSO)
PF7(BACKSCR)
PF8(SCROLL)
PF9(NEXTSESS)
PF10(REFRESH)
PF11(FWDRETR)
PF12(RETRIEVE)
PF13(HELP)
PF14(SUBCOMMAND)
PF15(RETURN)
PF16(TOP)
PF17(BOTTOM)
PF18(TSO)
PF19(BACKSCR)
PF20(SCROLL)
PF21(NEXTSESS)
PF22(REFRESH)
PF23(FWDRETR)
PF24(RETRIEVE)
The options string can be from 1 to 1000 characters in length, and should contain valid run-time options. It should not contain options such as POSIX(OFF), TRAP(OFF), TRAP(ON,NOSPIE), or MSGFILE(), or characters such as slashes, unbalanced parentheses or quotes, or imbedded NULL characters. Specifying such options or using these characters will cause unpredictable problems when the TSO/E OMVS command runs.
If the RUNOPTS operand is omitted, OMVS uses the RUNOPTS string defined in the BPXPRMxx member of SYS1.PARMLIB that is active for the OMVS kernel. If no RUNOPTS string was defined in BPXPRMxx, no default run-time options are used when the TSO/E OMVS command starts up.
For more information, refer to z/OS Language Environment Programming Guide which contains a discussion about restrictions on _CEE_RUNOPTS environment variable settings.
The WRAPDEBUG(n) value specifies how many lines of debug data OMVS writes out before wrapping around to the top of the debug data set. The default number of lines is 10 000. The value of n must be between 100 and 1 000 000 000. The debug data set must be large enough to hold n 80-byte lines of debug data. If the debug data set is too small, debug recording stops when the data set fills up.
? is a short form for the Help subcommand.
Normally, any Language Environment error messages from the OMVS command are displayed on the TSO/E terminal. If you want to redirect these messages, you need to allocate the SYSFSUMM ddname instead of the SYSOUT ddname, as is usual with Language Environment applications.
These examples explain how to use the multi-session capability of OMVS:
OMVS SESSIONS(2)
OMVS PF1(NEXTSESS)