CINSERT

Purpose

Use the CINSERT subcommand to insert text in the current line starting at the column pointer. As a result, the data is shifted to the right.

Operands

text: is the group of characters to be inserted starting at the column pointer.

Usage Notes

You can insert blanks with the CINSERT subcommand. The operand must contain as many blanks as you want to insert. (You cannot enter the CINSERT subcommand without an operand.)
If SET SPILL OFF is in effect (the default), characters that have been pushed beyond the truncation column are truncated. If SET SPILL ON or SET SPILL WORD has been entered, characters that have been pushed beyond the truncation column are inserted in the file as one or more new lines, starting with the first character or word that would have gone beyond the truncation column.
Use the CLOCATE subcommand to move the column pointer to the desired location.
If the column pointer is at Zone1–1 (TOL) or Zone2+1 (EOL), no characters are inserted.

Examples

In the following example, the column pointer is moved and text is inserted starting at the column pointer. For more information, see z/VM: XEDIT User's Guide.

Current Line:

===== Mount Everest is high.
      |...+....1....+....2....+....3....+....4....+....5....+....6....

cl /high/

(move the column pointer)

ci exactly 29,000 feet

(one blank is entered after feet for spacing)

===== Mount Everest is exactly 29,000 feet high.
      <...+....1....+..|.2....+....3....+....4....+....5....+....6....

Responses

The column pointer remains unchanged.

Messages and Return Codes

503E: {Truncated|Spilled} [RC=3]
545E: Missing operand(s) [RC=5]
585E: No line(s) changed [RC=4]

where return codes are:

0: Normal
3: Truncated or spilled
4: No line(s) changed
5: Missing operand(s)
6: Subcommand rejected in the profile due to LOAD error, or QUIT subcommand has been issued in a macro called from the last file in the ring