|
HP OpenVMS Systems Documentation |
|
HP OpenVMS System Management Utilities Reference Manual
Chapter 26
|
| Command | Description |
|---|---|
| CREATE_LOG | Creates a new XA Gateway log |
| EXIT | Exits XGCP |
| START_SERVER | Starts the XA Gateway server |
| STOP_SERVER | Stops the XA Gateway server |
RUN SYS$SYSTEM: XGCP
To invoke XGCP, enter the following command at the DCL prompt:
$ RUN SYS$SYSTEM:XGCPXGCP displays the following prompt, at which you can enter any XGCP command:
XGCP>To exit from XGCP, enter the EXIT command at the XGCP prompt, or press Ctrl/Z.
Creates a new XA Gateway log. Requires SYSPRV privilege or read/write access to the SYS$JOURNAL directory.
CREATE_LOG /GATEWAY_NAME=name /SIZE=size
None.
/GATEWAY_NAME=name
This qualifier is required. Specify a gateway name of up to 15 characters.Creates a gateway log named SYS$JOURNAL:name.DDTM$XG_JOURNAL. Create a separate Gateway log for each Gateway name under which you want your XA applications to run.
/SIZE=size
Specifies the initial size of the log, in blocks. If you omit this qualifier, the log is created with an initial size of 242 blocks. The log file is automatically expanded in size when necessary.
XGCP> CREATE_LOG/GATEWAY_NAME=MYLOG1/SIZE=150
|
The command in this example creates a gateway log named SYS$JOURNAL:MYLOG1.DDTM$XG_JOURNAL. Its initial size is 150 blocks.
Exits XGCP. You can also press Ctrl/Z to exit from XGCP.
EXIT
None.
None.
Starts the XA Gateway server. Requires IMPERSONATE privilege.
START_SERVER
None.
None.
XGCP> START_SERVER
|
The command in this example executes the DCL command file SYS$STARTUP:DDTM$XG_STARTUP.COM, which starts the server process called DDTM$XG_SERVER.
Stops the XA Gateway server process, called DDTM$XG_SERVER, on the current node.Requires OPER, SYSPRV and AUDIT privileges.
STOP_SERVER
None.
None.
XGCP> STOP_SERVER
|
The command in this example stops the Gateway server process, called DDTM$XG_SERVER.
By default, the access control list editor (ACL editor) prompts you for each access control entry (ACE) and provides values for some of the fields within an ACE. You can navigate the ACE fields by using keypad commands, such as FIELD and ITEM.
This appendix describes all the keypad editing commands supplied by the
ACL editor. You can supplement or change these key definitions by
modifying and recompiling the ACL editor section file
SYS$LIBRARY:ACLEDIT.TPU (see Appendix B for more information). To
get help on the ACL editor keypad commands, press PF2.
A.1 ACL Editor Keypad Commands
Figure A-1 shows the default ACL editor keypad commands for LK201 keyboards. The numeric keypad on VT100-series terminals is identical to that of the LK201 keyboard shown in Figure A-1; VT100 terminals, however, do not have the supplemental editing keypad (keys E1 through E6).
Figure A-1 Keypad for an LK201-Series Keyboard
Table A-1 describes each of the keypad commands you can use with the ACL editor. In this table, KPn refers to a keypad key labeled with the number n. For example, KP4 refers to the keypad key labeled with the number 4.
| Command | Key or Key Sequence |
Description |
|---|---|---|
| ADVANCE | KP4 | Sets the current direction forward for the FIND, FNDNXT, MOVE SCREEN, OVER ACE, and WORD commands. Movement is toward the end of the ACL. |
| ADV FIELD | GOLD-KP7 | Completes the current ACE field and moves the cursor to the next ACE field. |
| BACKUP | KP5 | Reverses the current direction for the FIND, FNDNXT, MOVE SCREEN, OVER ACE, and WORD keys. Movement is toward the beginning of the ACL. |
| BOTTOM | GOLD-KP4 | Positions the cursor after the last line of the last ACE. Any entries you add are placed at the end of the ACL. |
| DEL ACE | PF4 | Deletes the entire ACE in which the cursor is positioned and stores it in the delete-ACE buffer. |
| DEL C | Comma | Deletes the character on which the cursor is positioned and stores it in the delete-character buffer. |
| DEL EOL | GOLD-KP2 | Deletes text from the current cursor position to the end of the line and stores it in the delete-line buffer. |
| DEL W | Minus | Deletes the text from the current cursor position to the beginning of the next word and stores it in the delete-word buffer. |
| ENTER | Enter | Indicates that the current ACE is complete. The ACL editor terminates the insertion and verifies that the syntax of the ACE is complete. You can press the Enter key while the cursor is located at any position within the ACE. (Pressing the Return key produces the same results.) |
| EOL | KP2 | Moves the cursor to the end of the current line. |
| FIELD | KP7 | Completes the current ACE field and moves the cursor to the next ACE field or subfield, inserting text as needed. If the ACL editor is not in prompt mode, the ACL editor advances to the next field in the current ACE. |
| FIND | GOLD-PF3 | Searches for an occurrence of a string. Press the FIND key and then enter the string from the main keyboard. Press the ENTER key to search for the string in the current direction, or the ADVANCE or BACKUP key to change the search direction. |
| FNDNXT | PF3 | Searches in the current direction for the next occurrence of the string previously entered with the FIND key. |
| GOLD | PF1 | When pressed before another keypad key, specifies the second key's alternate function (the bottom function on the keypad diagram). |
| HELP | PF2 | Displays information about using the editing keypad. |
| HELP FMT | GOLD-PF2 | Displays information about ACE formats. |
| INSERT | GOLD-KP0 | Moves all text from the current line down one line, leaving a blank line where an ACE is to be inserted. |
| ITEM | Period | Selects the next item for the current ACE field. If the ACL editor is not in prompt mode, this key is ignored. |
| MOVE SCREEN | KP8 | Moves the cursor one screen in the current direction (see ADVANCE or BACKUP). A screen is defined as two-thirds the number of lines in the display. |
| OVER ACE | KP0 | Moves the cursor to the beginning of the next ACE (if the direction is set to ADVANCE) or to the beginning of the previous ACE (if the direction is set to BACKUP). |
| TOP | GOLD-KP5 | Moves the cursor position to the first character of the first ACE in the access control list. |
| UND ACE | GOLD-PF4 | Inserts the contents of the delete-ACE buffer in front of the ACE in which the cursor is currently positioned. |
| UND C | GOLD-Comma | Inserts the contents of the delete-character buffer directly in front of the cursor. |
| UND W | GOLD-Hyphen | Inserts the contents of the delete-word buffer directly in front of the cursor. |
| WORD | KP1 | Moves the cursor one word forward (if the direction is set to ADVANCE) or backward (if the direction is set to BACKUP). |
In addition to keypad editing, the ACL editor lets you use other keyboard keys and key sequences to perform editing functions. Table A-2 describes these additional ACL editing keys and key sequences. Keys in parentheses indicate the equivalent key for an LK201-series keyboard.
| Key or Sequence | Action Taken When Key or Sequence Is Pressed |
|---|---|
| DOWN ARROW KEY | Moves the cursor to the character directly in line below it. If the ACE in which the cursor is positioned is new, the ACL editor processes the ACE before moving the cursor. If the entry is incomplete or formatted incorrectly, an error occurs and the cursor does not move. |
| LEFT ARROW KEY | Moves the cursor one character to the left. If the cursor is at the left margin, moves it to the rightmost character in the line above. |
| RIGHT ARROW KEY | Moves the cursor one character to the right. If the cursor is at the right margin, moves it to the leftmost character in the line below. |
| UP ARROW KEY | Moves the cursor to the character directly in line above it. If the ACE in which the cursor is positioned is new, the ACL editor processes the ACE before moving the cursor. If the entry is incomplete or formatted incorrectly, an error occurs and the cursor does not move. |
| GOLD- <- | Shifts the text in the display window 8 characters to the left. |
| GOLD--> | Shifts the text in the display window 8 characters to the right. |
| Backspace (F12) | Moves the cursor to the beginning of the current line. |
| Ctrl/A | Changes the current mode from insert mode to overstrike mode or from overstrike mode to insert mode. Insert mode (the default) inserts a character to the left of the current character. Overstrike mode replaces the current character. |
| Ctrl/D | Allows you to execute one TPU command. |
| Ctrl/H | Moves the cursor to the beginning of the line. (Performs the same function as the backspace key.) |
| Ctrl/J | Deletes the text from the cursor back to the beginning of the word. (Performs the same function as the linefeed key.) |
| Ctrl/R | Refreshes the screen display. Clears and redraws the screen, deleting any extraneous characters or messages that might have appeared on the screen but are not part of the ACL you are editing. (Performs the same function as Ctrl/W.) |
| GOLD-Ctrl/R | Returns the ACL to its original state before the ACL editor was invoked. (Performs the same function as GOLD-Ctrl/W.) |
| Ctrl/U | Deletes the text from the cursor to the beginning of the line. |
| GOLD-Ctrl/U | Inserts the contents of the deleted-line buffer into the line at the current position. The line might wrap automatically. |
| Ctrl/W | See Ctrl/R. |
| GOLD-Ctrl/W | See GOLD Ctrl/R. |
| Ctrl/Z | Ends the editing session and updates the ACL. (Unless otherwise specified, any recovery and journal files are deleted.) |
| GOLD-Ctrl/Z | Ends (quits) the editing session without saving any of the changes made to the ACL. (Unless otherwise specified, any recovery and journal files are deleted.) |
| DELETE KEY | Deletes the character to the left of the cursor. |
| Linefeed (F13) | Deletes the text from the cursor back to the beginning of the word. If the cursor is positioned at the first character of the word, deletes to the beginning of the previous word. |
| Tab | Moves the text located to the right of the cursor to the next tab stop. |
You can use the supplemental keypad on an LK201-series keyboard to move sections of text from one part of an ACL to another. However, note that certain supplemental editing keys (Insert Here, Remove, and Select) require a PASTE buffer, which is not enabled by default. To enable the PASTE buffer for the current editing session, perform the following actions:
TPU command: ACLEDIT$X_PASTE_BUFFER:=1 |
TPU command: ACLEDIT$X_CHECK_MODIFY:=0 |
To enable the PASTE buffer for all ACL editing sessions, change the values of the variables ACLEDIT$X_PASTE_BUFFER and ACLEDIT$X_CHECK_MODIFY in the ACL editor section file and recompile the file (see Appendix B).
Table A-3 describes the supplemental keypad keys you can use with the ACL editor.
| Key or Key Sequence |
Description |
|---|---|
| Find | Elicits the Search for: prompt as the first step in the FIND operation. Type the search string after the prompt; then, press either the Do key or the Enter key to process the search. Performs the same function as the FIND keypad command. |
| Insert Here | Indicates where an ACE is to be inserted or, if support for the PASTE buffer is enabled, indicates the line where the selected text in the PASTE buffer is to be inserted. |
| Remove | Removes the selected text to the PASTE buffer. Each time you press the Remove key, the ACL editor deletes the previous contents of the PASTE buffer. |
| GOLD-Remove (COPY) | Copies the selected text to the PASTE buffer. Each time you use the COPY command, the ACL editor deletes the previous contents of the PASTE buffer. |
| Select | Marks the beginning of a range of text to be removed or copied to the PASTE buffer. Press the Select key. Then, move the cursor to include the desired amount of text to be removed or copied. Press either Remove or GOLD-Remove (COPY) to complete the operation. |
| Prev Screen | Moves the cursor to the previous screen. By default, a screen is defined as two-thirds the number of lines in the display. |
| Next Screen | Moves the cursor one screen forward. By default, a screen is defined as two-thirds the number of lines in the display. |
| Previous | Next | Contents | Index |