s390xspec

Documentation

Overview

S390xspec reads the Principles of Operation PDF Manual to collect instruction encoding details and writes those details to standard output in CSV format.

Usage:

s390xspec z_Architecture_Principles_of_Operation.pdf > s390x.csv

Each CSV line contains three fields:

instruction
	The instruction heading, such as "BRANCH AND LINK".
mnemonic
	The instruction mnemonics, such as "BAL R1,D2(X2,B2)".
encoding
	The instruction encoding, a sequence of opcode and operands encoding in respective bit positions
	such as operand@bitposition each separated by |
	Ex: "45@0|R1@8|X2@12|B2@16|D2@20|"

For more on the exact meaning of these fields, see the Principle of Operations IBM-Z Architecture PDF Manual.